# BrandMov API

**Canonical:** https://apis.io/apis/brandmov-com/brandmov-com-api/  
**Provider:** BrandMov — https://apis.io/providers/brandmov-com/  
**Base URL:** https://api.brandmov.com  
**Documentation:** https://brandmov.com/docs/api/meta

BrandMov API is one of 2 APIs that [BrandMov](https://apis.io/providers/brandmov-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

BrandMov API as documented publicly: 47 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (47)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/account` | Get your account |
| GET | `/api/v1/account/api-keys` | List |
| POST | `/api/v1/account/api-keys` | API keys Mint |
| DELETE | `/api/v1/account/api-keys/{id}` | Revoke |
| GET | `/api/v1/account/workspaces` | Workspaces List |
| POST | `/api/v1/account/workspaces` | Create |
| DELETE | `/api/v1/account/workspaces/{workspaceId}` | Archive and restore |
| PATCH | `/api/v1/account/workspaces/{workspaceId}` | Rename |
| POST | `/api/v1/account/workspaces/{workspaceId}/unarchive` | Owner only. Archiving frees a slot under your plan limit; restoring takes one back, so it returns 402 when you're at the limit. |
| POST | `/api/v1/generate/ad-copy` | POST /api/v1/generate/ad-copy |
| GET | `/api/v1/meta/ad-accounts` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/ad-accounts/{accountId}/ads` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/ad-accounts/{accountId}/adsets` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/ad-accounts/{accountId}/campaigns` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/ad-accounts/{accountId}/pages` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| POST | `/api/v1/meta/ads` | Create an ad |
| POST | `/api/v1/meta/adsets` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| POST | `/api/v1/meta/campaigns` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| DELETE | `/api/v1/meta/connection` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/connection` | Status GET /api/v1/meta/connection writes_unlocked is false during the short cool-down after a new connection; writes_unlock_at says when it ends. |
| POST | `/api/v1/meta/connection` | POST /api/v1/meta/connection |
| PUT | `/api/v1/meta/connection/ad-account` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| POST | `/api/v1/meta/connection/link` | POST /api/v1/meta/connection/link |
| POST | `/api/v1/meta/connection/token` | Option 2: system-user token POST /api/v1/meta/connection/token |
| POST | `/api/v1/meta/creatives` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| POST | `/api/v1/meta/images` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| GET | `/api/v1/meta/insights/{objectId}` | BrandMov Meta Publishing API: campaigns, ad sets, creatives, ads |
| POST | `/api/v1/watchlists` | POST /api/v1/watchlists |
| GET | `/api/v1/watchlists/` | List watchlists |
| POST | `/api/v1/watchlists/page_url` | BrandMov Watchlists API: track competitor Meta ads |
| DELETE | `/api/v1/watchlists/{watchlistId}` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}/angles` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}/feed` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}/hooks` | BrandMov Watchlists API: track competitor Meta ads |
| POST | `/api/v1/watchlists/{watchlistId}/refresh` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}/strategy` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/api/v1/watchlists/{watchlistId}/winners` | BrandMov Watchlists API: track competitor Meta ads |
| GET | `/meta/ad-accounts` | GET /meta/ad-accounts and GET /meta/ad-accounts/{id}/pages to pick the account and the page the ad runs as. |
| GET | `/meta/ad-accounts/{id}/pages` | GET /meta/ad-accounts and GET /meta/ad-accounts/{id}/pages to pick the account and the page the ad runs as. |
| POST | `/meta/ads` | Create an ad POST /api/v1/meta/ads ties the creative to the ad set. |
| POST | `/meta/adsets` | POST /meta/adsets . |
| POST | `/meta/campaigns` | POST /meta/campaigns , then POST /meta/adsets . |
| GET | `/meta/connection` | Poll GET /meta/connection to see when it lands. |
| POST | `/meta/connection/link` | Option 1: browser link POST /api/v1/meta/connection/link Returns a link valid for 30 minutes. |
| POST | `/meta/creatives` | POST /meta/creatives with copy from /generate/ad-copy plus the image hash. |
| POST | `/meta/images` | POST /meta/images : image URL in, hash out. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/brandmov-com/openapi/_ae-authored/brandmov-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-post-api-v1-meta-creatives-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-post-api-v1-meta-campaigns-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-post-api-v1-meta-adsets-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-post-meta-adsets-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-get-meta-connection-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/brandmov-com/json-schema/brandmov-com-post-meta-creatives-request-schema.json

## Other BrandMov APIs (1)

- [BrandMov API](https://apis.io/apis/brandmov-com/brandmov-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brandmov-com/brandmov-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brandmov-com/.