First-request guide for List custom sources.
List custom sources
List custom sources
Overview
Returns a paginated list of sources, optionally filtered by source group.
Call the endpoint
Send a GET request to /integration/v1/custom-sources with the required authentication and parameters.
Quickstart
Follow these two steps to make a request and recognize a successful response.
Make a request
curl --request GET \
--url https://uapi.demandbase.com/integration/v1/custom-sources?group=custom \
--header "Authorization: Bearer $DB_API_KEY" \
--header "Accept: application/json"Read the response
{
"totalCount": 2,
"data": [
{
"id": 1,
"name": "Salesforce CRM",
"description": "Accounts imported from Salesforce.",
"sourceGroup": "custom",
"priority": 50
},
{
"id": 2,
"name": "HubSpot",
"description": "Contacts from HubSpot.",
"sourceGroup": "custom",
"priority": 51
}
]
}Request anatomy
Build the request from the method, path, parameters, and payload described below.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
group | query | string | Optional | Filter sources by source group. |
perPage | query | integer (int32) | Optional | Number of items per page. |
page | query | integer (int32) | Optional | Page number (1-indexed). |
Request body
This endpoint does not define a JSON request body.
Response anatomy
The endpoint returns 200 for the documented success case. A paginated list of sources.
The response schema does not enumerate fields; inspect the example response and status code.
Rules
- Use
GETwith the path/integration/v1/custom-sources. - Required inputs: No parameters are marked required in the published schema..
- Authenticate every request with a valid Demandbase access token.
- This endpoint does not require a JSON request body.
Filters
The published schema exposes the following endpoint inputs. Use the location column to place each value correctly.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
group | query | string | Optional | Filter sources by source group. |
perPage | query | integer (int32) | Optional | Number of items per page. |
page | query | integer (int32) | Optional | Page number (1-indexed). |
Errors
Handle non-success responses explicitly so your integration can report actionable failures.
| Status | Meaning |
|---|---|
400 | Request failed. |
401 | Request failed. |
500 | Request failed. |