---
title: "Update Campaign"
method: PUT
path: "/number-registration/1/campaigns/{campaignId}"
tags: ["platform", "numbers", "number-registration", "campaigns"]
---

# Update Campaign

`PUT /number-registration/1/campaigns/{campaignId}`

## 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/{campaignId}`
- 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

Updates a campaign that has not yet been registered within the Infobip platform or has been rejected by Infobip. This operation is only supported for campaigns that are in DRAFT or REJECTED stage.

## Path parameters

- `campaignId` string, uuid, required: The ID of the desired campaign.

## 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 `200`

OK

- 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
- `404`: Not Found
- `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)