---
title: "Create Campaign"
method: POST
path: "/number-registration/1/campaigns"
tags: ["platform", "numbers", "number-registration", "campaigns"]
---

# Create Campaign

`POST /number-registration/1/campaigns`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number-registration/1/campaigns`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Creates a campaign within the Infobip platform. This operation does not register the campaign with any networks. Registration can be done using created campaign's ID with the 'Register Campaign' endpoint.

## Headers

- `X-Resource-Request-Id` string

## Request body

- 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaign
  - `id` string, uuid: The identifier for the campaign.
  - `referenceId` string: Unique user defined ID for the campaign. While not required, it is recommended to supply a referenceId as the uniqueness constraint will help ensure a campaign is not accidentally created multiple times. Subsequent create requests with the same referenceId will be rejected with an error.
  - `applicationId` string: CPaaS X property identifying an application, a use case or an environment on your system. It should only be set if you are using CPaaS X Applications with your traffic.
  - `entityId` string: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.
  - `name` string, required: The name of the campaign.
  - `createdDate` string, date-time: The date and time when the campaign was created.
  - `lastModifiedDate` string, date-time: The date and time when the campaign was last modified.
  - `stage` 'DRAFT' | 'SUBMITTED_FOR_REVIEW' | 'IN_REVIEW' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'APPROVED_BY_INTERNAL_REVIEWER' | 'SUBMITTED' | 'REJECTED_EXTERNALLY' | 'REGISTERED' | 'REJECTED' | 'ON_HOLD' | 'DEREGISTERED' | 'REGISTERED_PENDING_UPDATE' | 'REGISTERED_PENDING_DEREGISTRATION' | 'ARCHIVED' | 'BLOCKED' | 'SUSPENDED' | 'APPEALED' | 'IN_MIGRATION' | 'PAUSED'
  - `priority` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aPriorityInfo: Priority information used in latest campaign review.
    - `priorityId` string, uuid: Id of a priority
    - `submittedDate` string, date-time: Date submitted for review
  - `campaignFeedback` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaignFeedback: Offers additional information regarding the campaign, includes rejection reason and time.
    - `rejectionReasons` string[]: The reasons for the rejection.
    - `rejectionDetails` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aRejectionReason[]: Rejection reasons details.
      - `errorCode` string: Predefined code.
      - `description` string: Rejection reason.
      - `recommendedAction` string: Recommended action.
    - `rejectionDate` string, date-time: The time of the rejection.
  - `type` 'TEN_DIGIT_LONG_CODE' | 'EXTERNAL_TEN_DIGIT_LONG_CODE' | 'SHORT_CODE' | 'DCA2_TEN_DIGIT_LONG_CODE' | 'TOLL_FREE_NUMBER' | 'TOLL_FREE_UNIFIED_NUMBER' | 'TOLL_FREE_EXTERNALLY_VERIFIED' | 'RCS_SENDER_LAUNCH': Campaign type.

## Response `201`

Created

- 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaign
  - `id` string, uuid: The identifier for the campaign.
  - `referenceId` string: Unique user defined ID for the campaign. While not required, it is recommended to supply a referenceId as the uniqueness constraint will help ensure a campaign is not accidentally created multiple times. Subsequent create requests with the same referenceId will be rejected with an error.
  - `applicationId` string: CPaaS X property identifying an application, a use case or an environment on your system. It should only be set if you are using CPaaS X Applications with your traffic.
  - `entityId` string: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.
  - `name` string, required: The name of the campaign.
  - `createdDate` string, date-time: The date and time when the campaign was created.
  - `lastModifiedDate` string, date-time: The date and time when the campaign was last modified.
  - `stage` 'DRAFT' | 'SUBMITTED_FOR_REVIEW' | 'IN_REVIEW' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'APPROVED_BY_INTERNAL_REVIEWER' | 'SUBMITTED' | 'REJECTED_EXTERNALLY' | 'REGISTERED' | 'REJECTED' | 'ON_HOLD' | 'DEREGISTERED' | 'REGISTERED_PENDING_UPDATE' | 'REGISTERED_PENDING_DEREGISTRATION' | 'ARCHIVED' | 'BLOCKED' | 'SUSPENDED' | 'APPEALED' | 'IN_MIGRATION' | 'PAUSED'
  - `priority` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aPriorityInfo: Priority information used in latest campaign review.
    - `priorityId` string, uuid: Id of a priority
    - `submittedDate` string, date-time: Date submitted for review
  - `campaignFeedback` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aCampaignFeedback: Offers additional information regarding the campaign, includes rejection reason and time.
    - `rejectionReasons` string[]: The reasons for the rejection.
    - `rejectionDetails` 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aRejectionReason[]: Rejection reasons details.
      - `errorCode` string: Predefined code.
      - `description` string: Rejection reason.
      - `recommendedAction` string: Recommended action.
    - `rejectionDate` string, date-time: The time of the rejection.
  - `type` 'TEN_DIGIT_LONG_CODE' | 'EXTERNAL_TEN_DIGIT_LONG_CODE' | 'SHORT_CODE' | 'DCA2_TEN_DIGIT_LONG_CODE' | 'TOLL_FREE_NUMBER' | 'TOLL_FREE_UNIFIED_NUMBER' | 'TOLL_FREE_EXTERNALLY_VERIFIED' | 'RCS_SENDER_LAUNCH': Campaign type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)