---
title: "Register Campaign"
method: POST
path: "/v2/a2p/campaign"
tags: ["v2", "a2p-registration"]
---

# Register Campaign

`POST /v2/a2p/campaign`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/a2p/campaign`
- Auth: HTTP bearer

Register an A2P campaign under an existing brand.

Creates a Messaging Service and A2P Campaign in Twilio.
The brand must be in APPROVED, PENDING, or IN_REVIEW state.

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- CampaignRegistrationRequest: Request body for A2P campaign registration.
  - `brand_registration_id` string, required
  - `usecase` string, required: MIXED, MARKETING, CUSTOMER_CARE, DELIVERY_NOTIFICATIONS, etc.
  - `description` string, required: Description of what this campaign does
  - `message_flow` string, required: How end-users opt in to receive messages
  - `message_samples` string[], required: 1-5 sample messages
  - `opt_in_message` string, required
  - `opt_out_message` string
  - `help_message` string
  - `has_embedded_links` boolean
  - `has_embedded_phone` boolean

## Response `201`

Successful Response

- CampaignRegistrationResponse: Response for campaign registration.
  - `id` string, required
  - `brand_registration_id` string, required
  - `status` string, required
  - `usecase` string, required
  - `description` string, required
  - `failure_reason` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)