Ad Account Connection

This endpoint generates a link that allows users to seamlessly connect their Ad accounts for the purpose of creating advertisements.

POST /auth/create_link

Ad Account Connection

cURL

curl --request POST \
  --url https://public.plai.io/auth/create_link \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userId": "<string>",
  "platform": "<string>",
  "redirectUri": "<string>",
  "state": "<string>"
}
'

200

{
  "success": true,
  "results": {
    "success": true,
    "link": "<string>",
    "error": "<string>"
  }
}

Request Body

userId · string · required

User Id, If not already created, make a user on create user page first. If already created, retrieve the user ID from get profile page.

platform · string · required

For Facebook or Instagram, set platform = FACEBOOK, for LinkedIn, set platform = LINKEDIN, for Google, set platform = GOOGLE.

redirectUri · URL

The URL users are redirected to after linking their accounts

state · string

State, (if you want to send object make sure it is stringify)

Response

success · boolean

Indicates that the HTTP response was successful (status code 200 OK).

results · object

Show Results

success · boolean

Indicates whether the specific operation or API action was successful.

link · string

Generated URL with parameters and redirect URL

error · string

Error message if something went wrong