Skip to main content

List custom object records

GET 
/custom_objects/:object_name/records

List custom object records Note: This endpoint will only work if a Sync is setup with the Supaglue managed destination.

Support:

ProviderSupported
HubspotYes
SalesforceYes
PipedriveNo
MS DynamicsNo

Request​

Path Parameters

    object_name stringrequired

    The unique name of the custom object. For Salesforce, this should end with __c. For Hubspot, this will typically be the singular form of the object.

    Example: MyCustomObject__c

Query Parameters

    read_from_cache boolean

    Whether to read from Supaglue's Managed Destination cache or to read directly from the provider.

    NOTE: read_from_cache=true requires you to have the object synced to the Supaglue Managed Destination.

    Example: true
    modified_after date-time

    If provided, will only return objects modified after this datetime. Datetime must be in ISO 8601 format and URI encoded.

    Example: 2023-02-23T00:00:00Z
    page_size string

    Number of results to return per page. (Max: 1000)

    Example: 123
    cursor string

    The pagination cursor value

    Example: cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw

Header Parameters

    x-customer-id stringrequired

    The customer ID that uniquely identifies the customer in your application

    Example: my-customer-1
    x-provider-name stringrequired

    The provider name

    Example: salesforce

Responses​

Paginated Custom Objects

Schema
    pagination objectrequired
    next stringnullablerequired
    previous stringnullablerequired
    total_count number
    records object[]required
  • Array [
    • id stringrequired
    custom_object_name stringrequired
    data objectrequired
    property name* any
    is_deleted booleanrequired
    last_modified_at date-timerequired
  • ]
Loading...