---
title: "Submit resource request"
method: POST
path: "/resources/1/requests"
tags: ["platform", "resources", "resource-request"]
---

# Submit resource request

`POST /resources/1/requests`

## 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/resources/1/requests`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Submits a resource request with Infobip. Please note that costs may apply.

## Request body

- union
  - object
    - `type` 'ALPHANUMERIC_REGISTRATION', required: Type of resource.
    - `senderName` string, required: Sender name. GSM7 format required, with at least one letter.
    - `additionalContactEmails` string[]: Email addresses that would be contacted by Infobip support team for any request related matter.
    - `countryCode` string, required: Country code in two-letter ISO standard.
    - `trafficOrigin` 'LOCAL' | 'INTERNATIONAL': The location from which outbound messages are sent, relative to the country associated with the sender. - LOCAL: Indicates that the business sending the messages is headquartered in the same country as the sender being launched. - INTERNATIONAL: Indicates that the business is headquartered outside the country associated with the sender being launched.
    - `trafficType` 'PROMOTIONAL' | 'TRANSACTIONAL': Type of SMS messages you will send. - TRANSACTIONAL: Messages triggered by user actions or system events, such as one-time passwords (OTP/PIN), transaction alerts, password resets, or service notifications. - PROMOTIONAL: Messages sent for marketing or advertising purposes, such as promotions, offers, campaigns, or announcements.
    - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[], required: List of requirements for the resource.
      - `key` string, required: The key of the requirement.
      - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
    - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
      - `applicationId` string: ID of the Application that would be associated with the resource request.
      - `entityId` string: ID of the Entity that would be associated with the resource request.
    - `featureOptIns` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfAlphaFeatureOptInsApiDoc: Opt-in flags for optional features.
      - `structuredFeedback` boolean: Opt-in to receive structured and standardized validation feedback. When enabled, for UPDATE_REQUESTED and UPDATE_REQUESTED_BY_INTERNAL_REVIEWER statuses feedback is returned in the structured `feedback` field instead of the open-ended-text `requirementsFeedback` field, and for the REJECTED status feedback is returned in the structured `feedback` field instead of the open-ended-text `note` field. When enabled, resource requests that are auto-rejected for inactivity are set to the EXPIRED status instead of REJECTED. Defaults to false.
  - object
    - `type` 'NUMBER_PURCHASE', required: Type of resource.
    - `quantity` integer: Amount of numbers. Maximum per order by country: KR - 4.
    - `numberType` 'SHORT_CODE' | 'VIRTUAL_LONG_NUMBER' | 'TEN_DIGIT_LONG_CODE' | 'TOLL_FREE_NUMBER', required: Type of numbers.
    - `capabilities` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceNumberCapability[], required: Capabilities of the numbers.
    - `clientType` 'LOCAL' | 'INTERNATIONAL': Type of client. LOCAL resolves numbers preferring local options, falling back to international if none are available. INTERNATIONAL and null resolve international numbers only.
    - `additionalContactEmails` string[]: Email addresses that would be contacted by Infobip support team for any request related matter.
    - `countryCode` string, required: Country code in two-letter ISO standard.
    - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[]: List of requirements for the resource.
      - `key` string, required: The key of the requirement.
      - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
    - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
      - `applicationId` string: ID of the Application that would be associated with the resource request.
      - `entityId` string: ID of the Entity that would be associated with the resource request.
  - object
    - `type` 'RCS_SENDER_LAUNCH', required: Type of resource.
    - `senderName` string, required: Sender name.
    - `additionalContactEmails` string[]: Email addresses that would be contacted by Infobip support team for any request related matter.
    - `countryCode` string, required: Country code in two-letter ISO standard.
    - `excludedCarriers` string[]: List of carrier names excluded from the sender launch.
    - `trafficOrigin` 'LOCAL' | 'INTERNATIONAL', required: The location from which outbound messages are sent, relative to the country associated with the sender. - LOCAL: Indicates that the business sending the messages is headquartered in the same country as the sender being launched. - INTERNATIONAL: Indicates that the business is headquartered outside the country associated with the sender being launched.
    - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[], required: List of requirements for the resource.
      - `key` string, required: The key of the requirement.
      - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
    - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
      - `applicationId` string: ID of the Application that would be associated with the resource request.
      - `entityId` string: ID of the Entity that would be associated with the resource request.
    - `featureOptIns` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfRcsSenderFeatureOptInsApiDoc: Opt-in flags for optional features.
      - `structuredFeedback` boolean: Opt-in to receive structured and standardized validation feedback. When enabled, for UPDATE_REQUESTED and UPDATE_REQUESTED_BY_INTERNAL_REVIEWER statuses feedback is returned in the structured `feedback` field instead of the open-ended-text `requirementsFeedback` field, and for the REJECTED status feedback is returned in the structured `feedback` field instead of the open-ended-text `note` field. When enabled, resource requests that are auto-rejected for inactivity are set to the EXPIRED status instead of REJECTED. Defaults to false.
      - `senderInfoUpdates` boolean: Opt-in to receive sender information updates on the RCS sender launch flow. When enabled, correct sender info directly through [Update an RCS sender](/docs/api/channels/rcs/rcs-service-management/rcs-sender-management/update-rcs-sender), then update the resource request, instead of submitting a new resource request. When enabled, this opt-in also enables `structuredFeedback`, because the update loop for this feature needs the structured feedback model. If you set `structuredFeedback` to false and enable this opt-in, the request is rejected. Defaults to false.

## Response `201`

Created

- C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceOrderIdentifier
  - `id` string, uuid: The ID of the resource request.

## 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)