An integration flow runs on behalf of a person or an organization to synchronize data between multiple applications. Each step of an integration flow is accessing a particular application, for example through an API, to retrieve, store or update some data. Usually an API requires a client to authenticate before the data can be accessed. Each step of an integration flow needs a
credential. Simply put, a credential is an object holding the required information to authenticate with an API. Let’s have a look at a couple of credential objects:
- API Key: if the integration connector is sending requests to a REST API using API key for authorization, then a credential is a simple object holding the API key.
- OAuth2: In case of a connector authorizing through OAuth2, the credential object holds multiple values, such as
- Database credentials: If a connector goes directly into an application’s database, the credential object holds database host url, port, database name, username, password.
As you can see in the examples above, a
credentialis specific to the API it is used to authenticate with. This means a credential for a Salesforce connector will not work with a credential for a Database connector or any other API.
Creating a credential for a flow
When creating a flow an credential must be chosen. You can either chose an existing one or create a new one. The following screenshot demonstrates how the credential is created for the Petstore API connector.
To create a credential, open the Navigational Menu and go to Credentials. Then click Create New Credential button:
You will need to fill in data for two input fields:
- Account name - an optional name for this credential
- API key - an API key to authenticate with the Petstore API. You can use the
secretAPI key to try out this API.
Once a credential is saved, it will be linked with the current step of the flow. It can be also reused in other steps of the same flow or other flows using same connector.
Credentials are structured by connectors. The green number on a connector icon tells you how many credentials exist for that connector.
Please note before saving a credential, the flowground platform performs a verification by sending a “dry” request to the particular API. This allows us to avoid saving invalid credentials caused by typos, invalidated API keys, etc.
A new credential can be added by pressing the
Add New Credential button that you can see at the end of the video above. An existing credential can also be edited or deleted. This is accomplished by clicking the
Delete button on an existing credential.
Please note that it is not possible to delete a credential used by an active integration flow as the flow would become broken. If you try to delete such a credential, a corresponding error message will be displayed. Please delete these flow first or reconfigure them to use another credentials.