---
title: "Create an sms app"
method: POST
path: "/v1/projects/{projectId}/sms/smsApps"
tags: ["SMS Apps"]
---

# Create an sms app

`POST /v1/projects/{projectId}/sms/smsApps`

Creates a new sms app for the given project.

## Path parameters

- `projectId` string, required

## Request body

- SmsInputSmsAppDto
  - `name` string, required — Name of SMS App to create.
  - `region` 'BR' | 'EU' | 'US', required — Region to create SMS app. (Allowed values for staging environment: `EU` or `US`).
  - `test` boolean — Deprecated. This field is no longer used and will be removed in a future release.
  - `convApiApp` boolean — Flag to create a new Conversation App alongside this SMS App
  - `convApiAppId` string — Id of an existing Conversation API App to link with the new SMS App. Mutually exclusive with `convApiApp`.

## Response `201`

Newly created sms app

- SmsSmsAppDto
  - `id` string, required — SMS App id.
  - `smsServiceId` string, required — Id of the SMS Service which the SMS App belongs to.
  - `name` string, required — Name of SMS App.
  - `status` 'ACTIVE' | 'BLOCKED' | 'DELETED' | 'DEPROVISIONING' | 'DEPROVISIONING_FAILED' | 'FAILED_ADD' | 'FAILED_BLOCK' | 'FAILED_DELETE' | 'FAILED_UNBLOCK' | 'FAILED_UPDATE' | 'IN_PROGRESS_ADD' | 'IN_PROGRESS_BLOCK' | 'IN_PROGRESS_DELETE' | 'IN_PROGRESS_UNBLOCK' | 'IN_PROGRESS_UPDATE' | 'PENDING_ADD' | 'PENDING_BLOCK' | 'PENDING_DELETE' | 'PENDING_UNBLOCK' | 'PENDING_UPDATE' | 'PROVISIONING' | 'PROVISIONING_ADD' | 'PROVISIONING_ADD_FAILED' | 'PROVISIONING_BLOCK' | 'PROVISIONING_BLOCK_FAILED' | 'PROVISIONING_FAILED' | 'PROVISIONING_UNBLOCK' | 'PROVISIONING_UNBLOCK_FAILED' | 'PROVISIONING_UPDATE' | 'PROVISIONING_UPDATE_FAILED' | 'STATUS_UNSPECIFIED' | 'UNRECOGNIZED', required — Status of SMS App.
  - `regions` string[], required — List of regions of the app.
  - `conversationApiAppDetails` SmsConversationApiAppDto
    - `id` string, required — ID of the app
    - `projectId` string, required — ID of the app project
    - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required — App region.
    - `channelStatus` 'ACTIVE' | 'FAILING' | 'PENDING' | 'UNRECOGNIZED' — Status of the channel credentials integration.
  - `test` boolean, required — True if the app is a test app.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/sinch/apis/provisioning-api.md) · [All operations](https://skmtc.net/sinch/apis/provisioning-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/provisioning-api/revisions/c78a716de420/schema)