Adlyft
  1. Connection
Adlyft
  • Introduction
  • Getting Started
  • Auth Mangment
    • Get User Token
      POST
    • Refresh User Token
      GET
  • Workspace Mangment
    • Create Workspace
      POST
    • Get single workspace
      GET
    • Update Workspace
      PATCH
    • Delete Worksapace
      DELETE
    • Change Workspace Admin
      PATCH
  • Team Mangment
    • Create Team
      POST
    • Get Enterprise Team
      POST
    • Assign member
      POST
    • Get team members
      GET
    • Get Team By ID
      GET
    • Update Team Name
      PATCH
    • Delete Team
      DELETE
  • Connection
    • Create Connection
      POST
    • Get all tenant connections
      GET
    • Get connections by teamId
      GET
    • List of ad accounts and their connection statuses.
      GET
    • Delete connection
      DELETE
    • Disconnect
      DELETE
    • Get insights
      GET
  • Ads Account Mangment
    • Assign ad account
      POST
    • Revoke ad account
      POST
    • Change ad account
      POST
  • Meta
    • Campaigns
      • Get Campaigns
      • Update Campaign Status
      • Create Lead Campaign
      • Create Traffic Campaign
      • Create Sales Campaign
      • Create Awareness Campaign
      • Create Engagement Campaign
    • Lead Form
      • Get Page Lead forms
      • Create Page Lead form
    • Pixels
      • Get Pixels
      • Create Pixel
    • Audience
      • Get Saved Audience
      • Get Custom Audience
    • Import
    • Facebook pages
    • Targeting Search
    • Get Ads
    • Get AdSet
    • Get AdCreative
    • Get Insights
  1. Connection

Create Connection

Developing
POST
connections
Generates an authorization URL for connecting an external platform (e.g., Meta, Google Ads, etc.). Automatically assigns a team if not provided.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://staging.api.adlyft.otomatika.net/api/v1/connections' \
--header 'x-api-key: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "platform": "meta",
  "workspaceId": "",
  "redirect": "https://example.xxx"
}'
Response Response Example
{
    "authUrl": "https://www.facebook.com/v21.0/dialog/oauth?client_id=779794021555530&redirect_uri=https%3A%2F%2Fc1223cc09a3f.ngrok-free.app%2Fapi%2Fv1%2Fmeta%2Fredirect%2Fcallback&state=%7B%22tenantId%22%3A%22c71972e1-b6a6-429a-9c21-0bde821c9305%22%2C%22teamId%22%3A%22783e5cdb-a008-4663-be7b-1016fb0e6408%22%7D&scope=ads_management,ads_read,pages_show_list&response_type=code"
}
Modified at 2025-12-01 13:18:40
Previous
Connection
Next
Get all tenant connections
Built with