First-request guide for Get field mappings.
Get field mappings
Get field mappings
Overview
Returns the field mappings configured for the given source and object type.
Call the endpoint
Send a GET request to /integration/v1/custom-sources/{source_id}/field-mappings/{object_type} 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/field-mappings/account \
--header "Authorization: Bearer $DB_API_KEY" \
--header "Accept: application/json"Read the response
{
"fieldMappings": [
{
"sourceFieldLabel": "annual_revenue",
"demandbaseFieldName": "annualRevenue",
"dataType": "number"
},
{
"sourceFieldLabel": "hq_country",
"demandbaseFieldName": "country",
"dataType": "string"
}
]
}Request anatomy
Build the request from the method, path, parameters, and payload described below.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| value | Optional | ||
| value | Optional |
Request body
This endpoint does not define a JSON request body.
Response anatomy
The endpoint returns 200 for the documented success case. Field mappings for the specified source and object type.
The response schema does not enumerate fields; inspect the example response and status code.
Rules
- Use
GETwith the path/integration/v1/custom-sources/{source_id}/field-mappings/{object_type}. - 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 | ||
| 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. |