API Reference / Destinations

Destinations

A destination is an ad platform or analytics tool that conversions fire to, like Google Ads, Meta, or GA4. Each site has its own connections, one per destination type, so listing, getting, connecting and disconnecting a destination, and creating an OAuth handoff, all take a site_id. It is required for account-wide keys on multi-site accounts, otherwise the request is refused with 400 site_id_required. Connecting most platforms uses OAuth through a connect popup, so you don't pass credentials.

The destination object

string

A fixed type id, e.g. dest_google-ads. Not a random UUID.

integration

string

The platform slug, e.g. google-ads.

name

string

Display name, e.g. Google Ads.

connected

boolean

True once credentials are configured and validated.

connection_metadata

object

Non-secret details once connected, e.g. account or measurement ids.

Endpoints

GET/v1/destinationsList every destination type and its connection state.GET/v1/destinations/{id}Retrieve a single destination.POST/v1/destinationsConnect Meta or GA4 by pasting a token.DELETE/v1/destinations/{id}Disconnect a destination from a site.GET/v1/destinations/{id}/conversionsList a destination's conversion actions.POST/v1/handoffsOpen a connect popup for a destination.POST/v1/destinations/oauth-handoffsStart a Google Ads or GA4 connection.GET/v1/handoffs/{id}Poll a handoff's status until it completes.POST/v1/handoffs/{id}/cancelCancel an in-progress handoff.

GET/v1/destinations

curl https://app.converly.io/api/v1/destinations \
  -H "Authorization: Bearer sk_live_…"

200 OK

{
  "data": [
    { "id": "dest_google-ads", "name": "Google Ads",
      "connected": true },
    { "id": "dest_meta", "name": "Meta Ads",
      "connected": false },
    { "id": "dest_google-analytics", "name": "Google Analytics 4",
      "connected": false }
  ],
  "has_more": false,
  "next_cursor": null
}