First-request guide for Get a custom source.
Get a custom source
Get a custom source
Overview
Returns a single source by its ID.
Call the endpoint
Send a GET request to /integration/v1/custom-sources/{id} 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/1 \
--header "Authorization: Bearer $DB_API_KEY" \
--header "Accept: application/json"Read the response
{
"id": 42,
"name": "Salesforce CRM",
"description": "Accounts imported from Salesforce.",
"sourceGroup": "custom",
"priority": 50
}Request anatomy
Build the request from the method, path, parameters, and payload described below.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| value | Optional |
Request body
This endpoint does not define a JSON request body.
Response anatomy
The endpoint returns 200 for the documented success case. The requested source.
The response schema does not enumerate fields; inspect the example response and status code.
Rules
- Use
GETwith the path/integration/v1/custom-sources/{id}. - 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
This endpoint has no additional filters or parameters beyond its authentication requirements.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| value | Optional |
Errors
Handle non-success responses explicitly so your integration can report actionable failures.
| Status | Meaning |
|---|---|
400 | Request failed. |
401 | Request failed. |
404 | Request failed. |
500 | Request failed. |