Destinations

Destinations are still a core Vendo concept, but in the current REST API they are not a standalone /api/v1/destinations resource.

Instead, destination behavior is represented by two API resources:

• Apps: the connected external app, such as Mixpanel, Segment, Google Ads, or Meta Ads
• Integrations: the actual flow that sends data from a source app into a destination app

How Destinations Map to the API

1. Find destination-capable apps

Use the apps API and filter by role=destination:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://app2.vendodata.com/api/v1/apps?role=destination"

Example response:

{
  "data": [
    {
      "id": "app_123",
      "accountId": "acct_123",
      "appType": "mixpanel",
      "displayName": "Mixpanel Production",
      "role": ["destination"],
      "state": "active",
      "errorMessage": null,
      "lastSyncAt": null,
      "createdAt": "2026-04-01T00:00:00Z",
      "updatedAt": "2026-04-01T00:00:00Z"
    }
  ]
}

2. Create an integration that uses the destination

Use the integrations API to connect a source app to a destination app:

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceAppId": "app_source_123",
    "destinationAppId": "app_destination_123",
    "dataType": "events",
    "config": {
      "global": {},
      "tasks": [
        { "task_type": "track_events" }
      ]
    },
    "schedule": {
      "frequencyValue": 1,
      "frequencyUnit": "hours",
      "rollingWindowDays": 7
    }
  }' \
  https://app2.vendodata.com/api/v1/integrations

3. Monitor destination sync jobs

Use the jobs API to inspect exports for an integration:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://app2.vendodata.com/api/v1/jobs?integration_id=int_123"

Common Destination Workflow

1. Browse supported destination app types in Catalog
2. Create an app connection with destination role via Apps
3. Create an Integration that points at that destination app
4. Use Jobs to monitor execution

Summary

If you are thinking in product terms, destinations are still destinations.

If you are thinking in REST resources:

• app connection = apps
• export flow = integrations
• execution = jobs