Facebook Ads

Campaigns Config

GET
/v1/facebook/ads/campaigns-config

Retrieve Facebook Ads campaign configuration data including campaign settings, objective, budget configurations, and campaign-level metadata.

This endpoint provides detailed configuration information for campaigns.

Dimensions Available:

  • Configuration ID, name, objective
  • Status: effective status, creation time, buying type
  • Budget: daily budget, lifetime budget

Limitations:

  • Maximum 5000 records per page
  • Supports date filtering via dateStart (ISO 8601 format)
  • Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

  • organizationId (required)
  • userId (optional)
  • integrationName (optional)
  • dateStart (optional)

Note: This endpoint returns configuration data and may not support dateEnd filtering.

Authorization

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Query Parameters

organizationId*string

Organization identifier (required)

userId?string

User identifier (optional)

integrationName?string

Integration name identifier (optional)

dateStart?string

Start date for filtering (optional, ISO 8601 format)

Formatdate
page?integer

Page number for pagination (optional)

Default1
limit?integer

Number of items per page (optional, max 5000)

Rangevalue <= 5000
Default500
orderBy?string

Field to order by (optional)

orderDirection?string

Order direction (optional)

Value in"ASC""DESC"

Response Body

Successful response

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/facebook/ads/campaigns-config?organizationId=organization_123&dateStart=2024-01-01"
{  "data": [    {      "id": "string",      "name": "string",      "objective": "string",      "effective_status": "string",      "created_time": "2019-08-24T14:15:22Z",      "buying_type": "string",      "daily_budget": 0,      "lifetime_budget": 0,      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}