Keystone Developers
Open Keystone
API reference

Console API

Meta Conversions API

4 endpoints.

GET/api/v1/admin/businesses/{business_id}/integrations/meta/capi

Get Meta CAPI config for a business

Parameters

NameInTypeDescription
business_idrequiredpathstring
authorizationheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_MetaCapiConfigData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredMetaCapiConfigData
MetaCapiConfigData fields
FieldTypeDescription
pixel_idstring | null
test_event_codestring | null
enabledbooleandefault false
connectedbooleandefault false
metadataResponseMetadata | null
ResponseMetadata fields
FieldTypeDescription
paginationPaginationMetadata | null
PaginationMetadata fields
FieldTypeDescription
limitrequiredinteger
next_cursorstring | null
prev_cursorstring | null
has_morerequiredboolean
has_prevbooleandefault false
total_countinteger | null
status_countsobject | null
object | null fields

Map of string to integer

lifecycle_countsLifecycleCounts | null
LifecycleCounts fields
FieldTypeDescription
leadintegerdefault 0
prospectintegerdefault 0
customerintegerdefault 0
former_customerintegerdefault 0
classification_countsClassificationCounts | null
ClassificationCounts fields
FieldTypeDescription
signalobject
object fields

Nested object (not expanded)

touchobject
object fields

Nested object (not expanded)

stageobject
object fields

Nested object (not expanded)

metaResponseMeta | null
ResponseMeta fields
FieldTypeDescription
totalinteger | null
total_countinteger | null
pageinteger | null
per_pageinteger | null
  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

PUT/api/v1/admin/businesses/{business_id}/integrations/meta/capi

Set Meta CAPI config (pixel id, enable, test event code)

Parameters

NameInTypeDescription
business_idrequiredpathstring
authorizationheaderstring | null

Request bodyrequired

application/jsonMetaCapiConfigBody
FieldTypeDescription
pixel_idrequiredstring
test_event_codestring | null
enabledbooleandefault false

Responses

200Successful Response
application/jsonSuccessResponse_MetaCapiConfigData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredMetaCapiConfigData
MetaCapiConfigData fields

MetaCapiConfigData, expanded above.

metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/admin/businesses/{business_id}/integrations/meta/capi/pixels

Discover Meta pixels on a business' connected ad account

Parameters

NameInTypeDescription
business_idrequiredpathstring
authorizationheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_MetaCapiPixelsData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredMetaCapiPixelsData
MetaCapiPixelsData fields
FieldTypeDescription
pixelsrequiredMetaPixelData[]
MetaPixelData[] fields

MetaPixelData (not expanded)

connectedbooleandefault true
metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/admin/businesses/{business_id}/integrations/meta/capi/test

Fire a test CAPI event (validate sender via Events Manager Test Events)

Parameters

NameInTypeDescription
business_idrequiredpathstring
authorizationheaderstring | null

Request bodyrequired

application/jsonMetaCapiTestBody
FieldTypeDescription
event_namestringdefault "Lead"
emailstring | null

Responses

200Successful Response
application/jsonSuccessResponse_MetaCapiTestResult_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredMetaCapiTestResult
MetaCapiTestResult fields
FieldTypeDescription
events_receivedintegerdefault 0
fbtrace_idstring | null
messagesstring[]default []
string[] fields
metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.