Share the Page with a partner business

Grants a partner business portfolio tasks on the Facebook Page behind this account. With ADVERTISE, the partner can run ads for the Page from ad accounts in its own portfolio, which is how an integrator advertises for an end user without touching the end user's ad accounts.

Meta only lets a user token share a Page that a business portfolio owns. A Page outside any portfolio must first be claimed into one at business.facebook.com; this endpoint answers 422 until that is done. Meta refuses a second grant to a portfolio that already has access instead of replacing its tasks, so that case answers 200 with alreadyShared: true and the tasks the partner currently holds. To change a partner's tasks, revoke and grant again.

After the grant, the partner assigns its own people to the Page with POST /v1/ads/page-users; Meta does not assign partner admins automatically. The Instagram professional account linked to the Page is returned in page so the partner can reference it; Meta exposes no API to share Instagram accounts, that is done in Business Settings.

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.accounts.grantBusinessPartner({  path: {    accountId: 'account_abc123',  },  body: {    businessId: 'business_abc123',  },});console.log(data);

{  "page": {    "id": "string",    "name": "string",    "business": {      "id": "string",      "name": "string"    },    "instagramBusinessAccount": {      "id": "string",      "username": "string"    }  },  "partner": {    "businessId": "string",    "permittedTasks": [      "string"    ]  },  "alreadyShared": true}