Activate adAccount

POST

/api/v1/ads-accounts/activate

Makes a discovered ad account usable for the authenticated external user. Only active accounts can broker tokens or return insights. Idempotent — re-activating an already-active account returns 200 with alreadyActive: true.

Plan limits are enforced here. On the Free plan, only 1 ad account may be active per platform (Meta, Google and TikTok each get an independent slot). Activating a second account on a platform that already has an active one returns 402 with error.code = "PLAN_LIMIT", carrying an upgrade / contact-us link in error.upgrade.url and error.contactUrl. Deactivating an account frees its platform slot.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠402Plan limit reached

🟠404Ad account not found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/ads-accounts/activate' \
--header 'x-api-key: MTc4ODk2MDQ0ODc1OF83MzZmM2RlMGRiODgzZmMxMWY3ZGRkMWMxNmE5NTQyMTU1NmM1ZDdkMmM3ZTRjNjk3OWQ3ZjAxYjFhMGZlMTEy' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7ImlkIjoiMjQxMWQxYzctMTFmMS00NDU4LWFiNWQtNWFiZTAxNmUzNDFkIiwidGVuYW50SWQiOiIzZDZkZmMyMC1kNDNlLTQ5ZDMtYTFjYy02YzkzZmRkY2M1NDUiLCJraW5kIjoiZXh0ZXJuYWxfdXNlciIsImV4dGVybmFsVXNlcklkIjoiZXh0ZXJuYWwtdXNlci0xMjMiLCJlbWFpbCI6bnVsbCwibmFtZSI6bnVsbH0sImlhdCI6MTc4ODk2MDY5NiwiZXhwIjoxNzg4OTgyMjk2fQ.c-AXOUKN8aVUZADMSYwZk8GgMRjIgT_CHlERP1i80UA' \
--header 'Content-Type: application/json' \
--data '{ "platform": "meta", "accountId": "act_1234567890" }'

Response Example

200 - Success

{"success":true,"data":{"accountId":"act_1234567890","platform":"meta","isActive":true,"alreadyActive":false,"overage":false}}

Refresh External User Token

Deactivate adAccount