Generate OAuth authorization URL

POST

/api/v1/connections

Creates the provider-specific authorization URL for a new connection owned by the authenticated external user.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Provider authorization URL for the requested platform.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/connections' \
--header 'x-api-key: MTc4ODk2MDQ0ODc1OF83MzZmM2RlMGRiODgzZmMxMWY3ZGRkMWMxNmE5NTQyMTU1NmM1ZDdkMmM3ZTRjNjk3OWQ3ZjAxYjFhMGZlMTEy' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImlkIjoiMjQxMWQxYzctMTFmMS00NDU4LWFiNWQtNWFiZTAxNmUzNDFkIiwidGVuYW50SWQiOiIzZDZkZmMyMC1kNDNlLTQ5ZDMtYTFjYy02YzkzZmRkY2M1NDUiLCJraW5kIjoiZXh0ZXJuYWxfdXNlciIsImV4dGVybmFsVXNlcklkIjoiZXh0ZXJuYWwtdXNlci0xMjMiLCJlbWFpbCI6bnVsbCwibmFtZSI6bnVsbH0sImlhdCI6MTc4ODk2MDY5NiwiZXhwIjoxNzg4OTgyMjk2fQ.c-AXOUKN8aVUZADMSYwZk8GgMRjIgT_CHlERP1i80UA' \
--header 'Content-Type: application/json' \
--data '{
    "platform": "meta",
    "redirect": "https://scalvo.ai"
}'

Response Example

200 - Example 1

{
    "authUrl": "https://accounts.google.com/o/oauth2/v2/auth?..."
}

Get all external-user connections

Check connection status