Skip to main content Skip to complementary content

Update datasource in account

PUT /accounts/{account_externalid}/datasources/{datasource_guid}

Updates a datasource (connected application) in a customer account. Note: it's not possible to change the connector_guid (e.g. Salesforce) of an existing datasource.

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.
  • automations: The automations using this datasource (hard linked, not soft-linked)

Path Parameters

Name Description Type
account_externalid - string
datasource_guid - string

Body Parameters

Name Description Type
name - string
params - array_object


  "name": "Salesforce connection",
  "params": [
      "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,
  "blends": [],
  "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!