---
title: "Register Campaign"
method: POST
path: "/v4/accounts/{voip_id}/10dlc/campaigns"
tags: ["10 DLC"]
---

# Register Campaign

`POST /v4/accounts/{voip_id}/10dlc/campaigns`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/10dlc/campaigns`
- Auth: HTTP bearer

Registers campaign with 10 DLC

## Path parameters

- `voip_id` integer, required

## Request body

- MessageTenDlcCampaign
  - `campaign_usage` object, required: Capmaign usage
    - `customerCare` boolean, nullable: Customer Care or Conversational
    - `accountNotification` boolean, nullable: Account Notification
    - `marketing` boolean, nullable: Marketing
    - `twoFactorAuth` boolean, nullable: 2FA (pin codes sent via SMS)
    - `deliveryNotification` boolean, nullable: Delivery Notification
    - `higherEducation` boolean, nullable: Higher Education
    - `campaignDescription` string, required: Capmaign description
    - `campaignName` string, required: Capmaign name
  - `campaign_message` object, required: Campaign messages
    - `optInKeywords` string, required: Opt-in keywords
    - `optInMessage` string, required: Opt-in message
    - `optOutKeywords` string, required: Opt-out keywords
    - `optOutMessage` string, required: Opt-out message
    - `helpKeywords` string, required: Help keywords
    - `helpMessage` string, required: Help message
  - `campaign_sms_content` object, required: SMS Content
    - `messageOne` string, required: Sample message 1
    - `messageTwo` string, required: Sample message 2
    - `messageThree` string, required: Sample message 3
    - `messageFlow` string, required: Message flow
  - `campaign_contact` object, required: Company information
    - `name` string, required: Name
    - `email` string, required: Email
  - `brandId` integer, required: ID of brand associated with the campaign
  - `extension_id` integer, required: ID of extension associated with the campaign

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)