Skip to content

Gateway Control Plane API Reference

Updated: Feb 6, 2026

Data Pipelines Objects

Pipeline

FieldDescription
id IDUnique id of the created gateway data pipeline.
name StringName of the created gateway data pipeline. Provided in the input parameter.
active BooleanData pipeline status. Indicate if the pipeline is active or not.
type PipelineTypeType of the data pipeline. for example, GATEWAY_PIPELINE
dataSources DataSourceShallowList of data sources associated with this data pipeline. Expected to be an empty list from the create data pipeline request.
dataDestinations DataDestinationShallowList of data destinations associated with this data pipeline. Expected to be an empty list from the create data pipeline request.
dataFilter DataFilterThe data filter contains a list of blocked event types which are associated with this data pipeline. Expected to be an empty list from the create data pipeline request.

DataSource

FieldDescription
id IDUnique identifier of the data source.
name StringName of the data source.
type DataSourceTypeType of the data source.
active BooleanThe status of the data source indicates if it is active or not.
associatedPipelines PipelineBasicInfoA list of data pipelines which contain this data source.

DataDestination

FieldDescription
id IDUnique identifier of the data destination.
name StringName of the data destination.
type DataDestinationTypeType of the data destination.
active BooleanThe status of the data destination indicates if it is active or not.
associatedPipelines PipelineBasicInfoA list of data pipelines which contain this data destination.

DataFilter

FieldDescription
filterStatus BooleanThe status of the data filter indicates if the filter is active or not.
blockedEventTypes [String]A list of blocked event type names. The blocked events won't be processed by the data pipeline.

PipelineDestinationFilter

FieldDescription
id IDUnique id of the created gateway data pipeline.
destinationId IDUnique identifier of the data destination.
destinationFilterStatus BooleanThe status of the pipeline destination filter indicates if the filter is active or not.
destinationFilterBlockedEventTypes [String]A list of blocked event type names. The blocked events won't be processed by the data destination in the specific data pipeline.

GatewayPixelConfig

FieldDescription
id IDUnique ID of the created Signals Gateway Pixel.
name StringName of the Signals Gateway Pixel.
enabledStatus BooleanThe status of the Signals Gateway Pixel indicates if it is active or not.
plugins [String]A list of enabled plugins for the Signals Gateway Pixel.
aamFields [String]The enabled advanced matching fields.
enableContactDataHash BooleanIndicate if the data hash is enabled for the Signals Gateway Pixel.
customIntegrityScript StringThe custom integrity script applied to the Signals Gateway Pixel.
estRuleGroups [PixelESTRuleGroupConfig]A list of event setup rules.
iwlParameters [PixelIWLParametersConfig]A list of IWL parameters.
creationSourcePlatform StringThe creation source platform of the Signals Gateway Pixel. It can be from Signals Gateway or imported from Meta Pixel.
creationSourceId StringThe creation source ID of the Signals Gateway Pixel. It can be the imported Meta Pixel ID.

PipelineBasicInfo

FieldDescription
id IDUnique id of the created gateway data pipeline.
name StringName of the created gateway data pipeline. Provided in the input parameter.
type PipelineTypeType of the data pipeline. for example, GATEWAY_PIPELINE.

ApiKeyAuth

FieldDescription
name StringName of the API key auth.
value StringValue of the API key auth.
addTo AddAuthToThe part of the request to add auth to.

BasicAuth

FieldDescription
credentials StringCredentials of the basic auth.

ClientCredentialsAuth

ValueDescription
authEndpoint StringThis is the URL of the authorization endpoint that the client will use to obtain an access token. The client will send a request to this endpoint to authenticate and obtain a token.
httpMethod HttpMethodTypeThis specifies the HTTP method (for example, POST, GET, etc.) that the client will use to send the authentication request to the authEndpoint.
clientId StringThis is a unique identifier for the client (for example, an application or a service) that is requesting access to the server. The clientId is used to identify the client and is typically provided by the server during the registration process.
clientSecret StringThis is a secret key that is associated with the clientId. The clientSecret is used to authenticate the client and is typically kept confidential to prevent unauthorized access.

JsonWebTokenAuth

FieldDescription
serviceUserAccount StringThis is the account name of the service user that is used to authenticate with the server. The service user account is typically a unique identifier for the client.
privateKey StringThis is the private key associated with the service user account. The private key is used to sign the JWT token, which is then sent to the server as part of the authentication request.

DataSourceType

Type
META_PIXEL
ADVERTISER_HOSTED_PIXEL
FILE_UPLOAD
UNKNOWN

DataDestinationType

Type
META_CONVERSIONS_API
CUSTOM_HTTP_API
AUDIENCE_STORAGE
GOOGLE_BIGQUERY_API
UNKNOWN

PipelineType

Type
META_CAPI_PIPELINE
GATEWAY_PIPELINE

HttpMethodType

Type
GET
POST
PUT
UNKNOWN

AuthType

Type
NONE
API_KEY
BASIC
CLIENT_CREDENTIALS
JSON_WEB_TOKEN
UNKNOWN

AddAuthTo

Type
HEADER
QUERY_PARAM
UNKNOWN

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About