---
title: "Check a partnership ad code"
method: POST
path: "/integrations/ads/meta/boost/eligibility"
tags: ["Ads"]
---

# Check a partnership ad code

`POST /integrations/ads/meta/boost/eligibility`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/integrations/ads/meta/boost/eligibility`
- Auth: API key in header `x-api-key`

Checks a creator's partnership ad code for the selected brand identity: through Meta's Advertisable Content API, or — when that lookup returns nothing for the app — by building a creative from the code on the ad account, reading back which post it promotes and deleting it again (no ad is created, nothing is scheduled, nothing bills). Reports whether Meta permits the boost, whether the post is the picked video (`postMatch`), and a preview thumbnail when only the customer can confirm the post.

## Request body

- object
  - `adAccountId` string, required
  - `brandPageId` string, required
  - `platform` 'instagram' | 'facebook', required
  - `platformVideoId` string, required
  - `adCode` string

## Response `200`

OK

- object
  - `eligible` boolean, required
  - `eligibility` string, nullable, required
  - `permissionStatus` string, nullable, required
  - `contentId` string, nullable, required
  - `permalink` string, nullable, required
  - `authorDisplayName` string, nullable, required
  - `matchesVideo` boolean, required
  - `reason` string, nullable, required
  - `consent` 'ad_code' | 'account_permission', nullable, required
  - `lookup` 'found' | 'empty' | 'unavailable', nullable, required
  - `verification` 'content_lookup' | 'creative_dry_run', nullable, required
  - `postMatch` 'confirmed' | 'unconfirmed' | 'mismatch', nullable, required
  - `previewThumbnailUrl` string, nullable, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)