Skip to main content Skip to complementary content

Create datasource in account

POST /accounts/{account_externalid}/datasources

Create a new datasource (connected application) in a customer account.

The required inputs of the connector (e.g. environment, API key etc.) have to be provided. Use Get connector to get the required and optional inputs of a connector.

If the connector uses oAuth, the user should be redirected to the link provided in the response. This link will start the oAuth authorization flow (for oAuth applications).

If the link is opened in a popup, the popup will close on a successful connection. When a redirect_url is provided, the user will be redirected to that redirect_url on a successful connection.

Fields in response:

  • link: the URL to which the user should be redirected to authorize access to the datasource (e.g. Salesforce or Hubspot) for connectors that use oAuth. This link is valid for 30 minutes.
  • is_used: true if the datasource is used in an automation. Note: a datasource can be loosely coupled, this means it is is used in an automation but not specifically set under the datasource settings of the blocks in an automation. In this case is_used will be false.
  • is_connected: false if the datasource is not connected, e.g. after a failed oAuth flow.

Path Parameters

Name Description Type
account_externalid - string

Body Parameters

Name Description Type Required
name - string Yes
connector_guid Use List connectors to get the guid of a connector. string Yes
redirect_url Optional, only for oAuth connectors. string
params Required if connector has required input params. Use Get connector to retrieve the inputs of a connector. array_object


  "connector_guid": "0d86f238-27c0-11ea-921c-022e6b5ea1e2", 
  "name": "Salesforce connection",
  "params": {
    "environment": "production",
    "api_key" : "12345"



  "guid": "fe35b720-0d53-11eb-b488-6f85f7dcde48",
  "name": "My Datasource name",
  "connector": {
    "guid": "0d86df6c-27c0-11ea-921c-022e6b5ea1e2",
    "name": "Teamleader"
  "is_used": false,
  "is_connected": false,
  "created_at": "2020-10-13T12:59:56.000000Z",
  "updated_at": "2020-10-13T12:59:56.000000Z",
  "additional": {
    "message": "This datasource requires user interaction to complete the setup.",
    "link": "https:\/\/\/datasources\/fe35b720-0d53-11eb-b488-6f85f7dcde48\/link?jwt=eyJ0eXAiOiJKV1QiL...dXJsIjpudWxsfQ.NzxuaD3W8fAPdkghzAeHpxmnf__ZDhfi_U9R7DscM1Q"



Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!