List destination objects
Request schema
Path parameters
ID of the destination
Query parameters
Designates which page of results to return. Always starts at 1. If 0 is specified, it defaults to 1.
Determines the number of results on each page. It can't exceed 100.
Organizes the results based on their creation time, either ascending or descending.
Header parameters
HTTP: basicAuth
HTTP AuthorizationScheme: basic
GET /api/v1/destinations/{destination_id}/objects?page=SOME_NUMBER_VALUE&per_page=SOME_NUMBER_VALUE&order=SOME_STRING_VALUE HTTP/1.1 Authorization: Bearer REPLACE_BEARER_TOKEN Host: app.getcensus.com
Responses
200
The outcome of the request
An object to help you navigate the list of results.
Total records in the collection.
Records on each page.
The previous page number, or null for the first page.
The current page number.
The next page number, or null if it's the last page.
The number of the last page with records.
The list of results.
The label for this object.
The full name for this object. This is used to identify the object in the API.
A list of the operations this object supports when being synced to.
Information on the primary identifier mapping requirements between the source and destination, per supported operation. The keys in this object correspond to the supported operations for this destination object.
additional property
Whether a primary identifier mapping must be provided for this operation.
Whether the destination key selector can be hidden in the UI for this operation. When true, the primary identifier mapping destination field can be hardcoded to the only available primary identifier field for the object. This is most commonly true for the append operation, when Census only needs to know the source column to use to identify new records.
Additional notes or instructions for this operation's configuration.
Whether or not you can define custom fields on this object.
A list of field types that can be used when creating custom fields on this destination object. Only present when allow_custom_fields is true. Each entry includes the type and whether it is an array type.
The data type of the custom field. This value should be used when defining the field_type for a custom field in the create sync payload. A type of Field is a generic type representing a field type of any.
Whether this is an array type. This value should be used when defining the array_field attribute for a custom field in the create sync payload.
Whether or not field names and labels are case sensitive on this 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.
The unique identifier for this field.
The data type of this field.
The human-readable label for this field.
The type of input control to use for this field.
The order in which this field should be displayed.
Placeholder text for the input field.
The default value for this field. Type varies based on the field type.
Whether this field is required to be provided.
Valid values for this field (typically used with dropdown input_type). Array items can be strings, integers, or other types.
Whether this field cannot be changed after the initial creation.
Conditional logic for when to show this field based on other field values.
URL to documentation providing more information about this field.
Operations where this field is applicable (e.g., merge, overwrite).
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.
Whether or not you can create a sync to this object. This will be false if the object has been deleted.
A list of fields associated with this destination.
The label for this field.
The full name for this field. This is used to identify the field in the API.
Whether or not this field can be created in the destination if it doesn't exist.
Whether or not this field can be updated in the destination.
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
Whether or not this field is an array type.
If a value exists in the destination for this field, whether or not it can be overwritten by Census.
Whether or not this field is required.
Whether or not this field can be the primary identifier for an upsert sync.
Whether or not this field can be the primary identifier for an update only sync.
Whether or not this field can be the primary identifier for a create only sync.
Whether or not this field can be the identifier for a lookup on its containing object.
What object, if any, that this field references.
The type of this field.
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.
additional property
Returned if the object is a list that membership operations can be performed upon. This specifies the lists that objects marked as is_audience_destination can be synced to.
Displays the lists that members can be synced to. Sync to an existing list by specifying its name or ID in the static list mapping of an Audience sync. See an example here.
The unique identifier of the list.
The name of the list.
{ "status": "success", "pagination": { "total_records": 14, "per_page": 25, "prev_page": 1, "page": 2, "next_page": 3, "last_page": 10 }, "data": [ { "label": "User", "full_name": "user", "supported_operations": [ "insert", "update", "upsert" ], "primary_identifier_mapping_attributes": { "upsert": { "required": true, "hide_destination_key": false, "notes": "Your identifier must be a valid email." }, "mirror": { "required": false, "hide_destination_key": false, "notes": null } }, "allow_custom_fields": true, "supported_custom_field_types": [ { "type": "String", "array": false } ], "allow_case_sensitive_fields": true, "advanced_configuration_field_definitions": [ { "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" ] } ], "supports_field_ordering": false, "can_be_sync_destination": true, "is_audience_destination": false, "fields": [ { "label": "External User ID", "full_name": "external_id", "createable": true, "updateable": true, "operations": [ "overwrite" ], "array": true, "preserve_values_supported": true, "required_for_mapping": true, "can_be_upsert_key": true, "can_be_update_key": true, "can_be_insert_key": true, "can_be_reference_key": true, "lookup_object": "company", "type": "string" } ], "configurable_field_definitions": { "http_endpoint": "string", "batch_size": "integer" }, "data": { "lists": [ { "id": "123456789", "name": "High Value Customers" }, { "id": "987654321", "name": "Newsletter Subscribers" } ] } } ] }