API Configuration

You can manage your X Ads connector programmatically using the Weld REST API. This page covers the key operations specific to X Ads.

Authentication

All API requests require an API key passed via the x-api-key header. You can create API keys in Settings → API Keys inside the Weld app.

curl https://connect.weld.app/connections \
  --header 'x-api-key: YOUR_API_KEY'

Integration ID

When creating connections or syncs for X Ads, use the following integration ID:

Parameter	Value
`integration_id`	`xAds`

Create a Connection

To connect X Ads via the API, create a connection bridge session:

curl https://connect.weld.app/connection_bridges \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "integration_id": "xAds",
  "label": "x-ads-production",
  "redirect_uri": "https://yourapp.com/callback"
}'

Manage Syncs

Operation	Method	Endpoint
List syncs	`GET`	`/elt_syncs`
Get sync details	`GET`	`/elt_syncs/{id}`
Update sync	`POST`	`/elt_syncs/{id}`
Enable sync	`POST`	`/elt_syncs/{id}/enable`
Disable sync	`POST`	`/elt_syncs/{id}/disable`
Get sync status	`GET`	`/elt_syncs/{id}/status`
Delete sync	`DELETE`	`/elt_syncs/{id}`

Manage Streams

Operation	Method	Endpoint
List available streams	`GET`	`/elt_syncs/{id}/available_source_streams`
Add streams	`POST`	`/elt_syncs/{id}/source_streams`
Trigger stream run	`POST`	`/elt_streams/{id}/request_run`
Request full refresh	`POST`	`/elt_streams/{id}/request_full_refresh`

For the full endpoint reference including request/response schemas, see the API Reference →.