Version: v3

Facebook Integration

Documentation for Ad-publishing API

📄️ Get current Facebook user

Retrieve the authenticated Facebook user profile for a location

Retrieve Facebook pages for the connected account. Without `limit` the response is an array of pages (this array response will soon be deprecated — migrate to the paginated form). When `limit` is provided the response is a paginated `{ pages, paging }` envelope; pass `after` (from `paging.next`) to fetch the next batch.

📄️ Get Instagram accounts for page

Retrieve Instagram accounts linked to a specific Facebook page

📄️ Get page lead forms

Retrieve lead gen forms for a specific Facebook page (published + drafts), sorted newest-first by `createdTime`. By default each form is returned in full (including its `questions`) as a plain array; pass `projection` (comma-separated) to return only the requested fields — any value outside the known field set is rejected. Pass `limit` (max 100) for a `{ forms, paging }` envelope; use `after` (from `paging.next`) to fetch the next batch.

📄️ Create page lead form

Create a new lead gen form on a Facebook page

📄️ Get ad accounts

Retrieve Facebook ad accounts available for the connected user

📄️ Get ad account details

Retrieve details of a specific Facebook ad account

📄️ Delete ad account

Remove a Facebook ad account connection from a location

📄️ Get conversation forms

Retrieve Facebook conversation lead forms for a location. Without `limit` the response is a plain array. When `limit` is provided (max 100) the response is a paginated `{ conversationForms, paging }` envelope; pass `after` (from `paging.next`) to fetch the next batch.