Introduction
Organization APIs
- Users
- Invitations
- Workspaces
Workspace APIs
- Syncs
- Sync Management Links
- Sync Runs
- Destination Types
- Destinations
- Destination Connect Links
- Source Types
- Sources
- Source Connect Links
- Segment Management Links
Create a new destination type
Create a new destination type for your given workspace. By default the destination type is created and scoped just to your workspace and not visible to other workspaces or orgs. See Scoped Destinations and Partner Destinations for more information on how to create destination types that are visible to other workspaces or orgs.
Authorizations
Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.
Body
The full name for this destination type. This is used to identify the destination type in the API.
The configuration fields required to create a destination of this destination type.
User-friendly label for the input.
The type of this field.
string
, boolean
, integer
, float
Whether the user can edit this field.
The default value for this field.
Unique id for this field in the configuration.
Placeholder text for the input.
Whether the field is required to set up a connection.
Whether the field is a secret. This ensures the frontend doesn't render secrets in plaintext.
The URL to the icon for this destination type. Must be <100kb and must be image/png
.
The name of this destination type.
Response
The full name for this destination type. This is used to identify the destination type in the API.
How to authorize a destination of this type of destination type.
credentials
, oauth
, other
Top level object containing a list of fields needed to create a connection of this type.
A hint to the user about this field, such as instructions for how to find the value
The name of this configuration field. This is used to identify the credential in the API to create a connection of this type.
If this is a credential field that contains sensitive data
A user facing name for this field
A regex string the value must match
A placeholder for this field, usually an example of its value
If this credential accepts a finite list of values, what those values are
A link to read more about this destination, usually linking to the Census docs.
Validations around this field, ie 'required'
The type of this field
string
, integer
, boolean
Whether you can create connections of this type using the Create Destination API. If you'd like to create a destination via API that isn't marked as creatable_via_api
, check out the docs for our Destination Connect Links if the destination is marked as creatable_via_connect_link
, or reach out to us.
Whether you can create connections of this type using Census Connect Links. If you'd like to create a destination via Connect Link that isn't currently supported, please reach out to us.
The path to this destination type's Census documentation, ie https://docs.getcensus.com/destinations/available-destinations/{documentation_slug}.
The name of this destination type.
Outcome of the operation.
success
, updated
, created
, not_found
, error
Was this page helpful?