Update destination

Authorizations

Authorization

string

header

required

Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.

Path Parameters

destination_id

integer

required

ID of the destination to update

Body

application/json

service_connection

object

Contains the information for the connection.

Show child attributes

service_connection.name

string

The name of this destination.

Example:

"Google Sheets"

service_connection.credentials

object

The credentials needed to create each type of connection. These can be found in the GET /connectors API for most destinations. For OAuth destinations, see this Notion doc.

service_connection.type

string

The type of connection to be used for this destination. A valid type is the service_name of a connector returned from the /connectors endpoint, where the connector is marked as creatable_via_api.

Response

200 - application/json

Successfully updated the destination

status

enum<string>

Outcome of the operation.

Available options:

success,

updated,

created,

not_found,

error

Example:

"updated"

data

object

Show child attributes

data.id

integer

The id of this destination.

Example:

12

data.name

string

The name of this destination.

Example:

"Google Sheets"

data.created_at

string<date-time>

When the connection was created

Example:

"2023-07-22T23:42:47.239Z"

data.last_test_results

object

Show child attributes

data.last_test_results.steps

object[]

An ordered array of steps representing the results of the last connection test. If one step fails then we won't surface details on later steps.

Show child attributes

data.last_test_results.steps.step

string

required

The name of the step in the connection test process.

Example:

"Verify connectivity"

data.last_test_results.steps.status

enum<string>

required

The status of the step.

Available options:

running,

success,

failed,

warning

Example:

"success"

data.last_test_results.steps.error

object

Show child attributes

data.last_test_results.steps.error.message

string | null

The error message associated with the step, if any.

data.last_test_succeeded

boolean | null

Indicates if the last connection test to this destination was successful.

Example:

true

data.last_tested_at

string<date-time> | null

Timestamp of when the last connection test was conducted on this destination.

data.connection_details

object

Connection details associated with this destination.

Example:

{
  "account_id": "7515011393,",
  "account_name": "Manager Account Test"
}

data.objects

object[]

A list of objects associated with this destination.

Show child attributes

data.objects.label

string

The label for this object.

Example:

"User"

data.objects.full_name

string

The full name for this object. This is used to identify the object in the API.

Example:

"user"

data.objects.supported_operations

enum<string>[]

A list of the operations this object supports when being synced to.

Available options:

append,

insert,

mirror,

update,

upsert

Example:

["insert", "update", "upsert"]

data.objects.allow_custom_fields

boolean

Whether or not you can define custom fields on this object.

Example:

true

data.objects.allow_case_sensitive_fields

boolean

Whether or not field names and labels are case sensitive on this object.

Example:

true

data.objects.advanced_configuration_field_definitions

object[]

An array of advanced configuration options for this object. Returns an empty array for destinations that don't support advanced configuration. Configuration options should be defined when creating syncs to this object via the advanced_configuration attribute in the create sync payload.

Show child attributes

data.objects.advanced_configuration_field_definitions.name

string

required

The unique identifier for this field.

data.objects.advanced_configuration_field_definitions.type

enum<string>

required

The data type of this field.

Available options:

string,

integer,

boolean,

object

data.objects.advanced_configuration_field_definitions.label

string

required

The human-readable label for this field.

data.objects.advanced_configuration_field_definitions.input_type

enum<string>

required

The type of input control to use for this field.

Available options:

text,

radio,

toggle,

checkbox,

dropdown,

textarea

data.objects.advanced_configuration_field_definitions.sort_order

integer

The order in which this field should be displayed.

data.objects.advanced_configuration_field_definitions.placeholder

string

Placeholder text for the input field.

data.objects.advanced_configuration_field_definitions.default

any

The default value for this field. Type varies based on the field type.

data.objects.advanced_configuration_field_definitions.required

boolean

Whether this field is required to be provided.

data.objects.advanced_configuration_field_definitions.supported_values

any[]

Valid values for this field (typically used with dropdown input_type). Array items can be strings, integers, or other types.

data.objects.advanced_configuration_field_definitions.immutable_after_create

boolean

Whether this field cannot be changed after the initial creation.

data.objects.advanced_configuration_field_definitions.show_when

object

Conditional logic for when to show this field based on other field values.

Example:

{ "file_format": ["CSV", "TSV"] }

data.objects.advanced_configuration_field_definitions.read_more

string

URL to documentation providing more information about this field.

data.objects.advanced_configuration_field_definitions.operations

string[]

Operations where this field is applicable (e.g., merge, overwrite).

Example:

[
  {
    "name": "http_endpoint",
    "type": "string",
    "label": "HTTP Endpoint",
    "input_type": "text",
    "placeholder": "/users",
    "sort_order": 1,
    "required": true
  },
  {
    "name": "batch_size",
    "type": "integer",
    "label": "Batch Size",
    "input_type": "textarea",
    "placeholder": "",
    "default": 1,
    "sort_order": 2
  },
  {
    "name": "http_method",
    "type": "string",
    "label": "HTTP Method",
    "input_type": "dropdown",
    "default": "POST",
    "sort_order": 3,
    "supported_values": ["POST", "PUT", "PATCH", "DELETE", "GET"]
  }
]

data.objects.supports_field_ordering

boolean

Whether or not you can set the field_order attribute on a sync to this object. Valid field_order configurations are alphabetical_column_name and mapping_order.

Example:

false

data.objects.can_be_sync_destination

boolean

Whether or not you can create a sync to this object. This will be false if the object has been deleted.

Example:

true

data.objects.fields

object[]

A list of fields associated with this destination.

Show child attributes

data.objects.fields.label

string

The label for this field.

Example:

"External User ID"

data.objects.fields.full_name

string

The full name for this field. This is used to identify the field in the API.

Example:

"external_id"

data.objects.fields.createable

boolean

Whether or not this field can be created in the destination if it doesn't exist.

Example:

true

data.objects.fields.updateable

boolean

Whether or not this field can be updated in the destination.

Example:

true

data.objects.fields.operations

enum<string>[]

For an array type, what operations are supported on this field. One of the following types:

overwrite: Overwrite existing values with inputted values
merge: Merge inputted values with existing values

Available options:

overwrite,

merge

data.objects.fields.array

boolean

Whether or not this field is an array type.

data.objects.fields.preserve_values_supported

boolean

If a value exists in the destination for this field, whether or not it can be overwritten by Census.

Example:

true

data.objects.fields.required_for_mapping

boolean

Whether or not this field is required.

Example:

true

data.objects.fields.can_be_upsert_key

boolean

Whether or not this field can be the primary identifier for an upsert sync.

Example:

true

data.objects.fields.can_be_update_key

boolean

Whether or not this field can be the primary identifier for an update only sync.

Example:

true

data.objects.fields.can_be_insert_key

boolean

Whether or not this field can be the primary identifier for a create only sync.

Example:

true

data.objects.fields.can_be_reference_key

boolean

Whether or not this field can be the identifier for a lookup on its containing object.

Example:

true

data.objects.fields.lookup_object

string

What object, if any, that this field references.

Example:

"company"

data.objects.fields.type

string

The type of this field.

Example:

"string"

data.objects.configurable_field_definitions

object

deprecated

DEPRECATED: A simplified map of configurable field definitions for this object, containing only the field types (e.g., {"http_endpoint": "string", "batch_size": "integer"}). This field is deprecated in favor of advanced_configuration_field_definitions, which provides complete field definitions including all attributes such as label, input_type, placeholder, sort_order, validation rules, and inclusion constraints. Please use advanced_configuration_field_definitions for new integrations.

Show child attributes

data.objects.configurable_field_definitions.{key}

string

Example:

{
  "http_endpoint": "string",
  "batch_size": "integer"
}

Introduction

Organization APIs

Workspace APIs

Authorizations

Path Parameters

Body

Response