API Reference / Destinations

Destinations

A destination is an ad platform or analytics tool that conversions fire to, like Google Ads, Meta, or GA4. Destinations are account-wide, one per type. 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.GET/v1/destinations/{id}/conversionsList a destination's conversion actions.POST/v1/handoffsOpen a connect popup for a destination.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
}