Public API

POST /api/v2/virtual-phone-accounts

Cria um novo número virtual móvel.

Request

Base URL
https://api.salvy.com.br
Auth
HTTP bearer
TypeScript
https://skmtc.dev/salvy/apis/salvy-api/docs/api/v2/virtual-phone-accounts/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

employeeIdstring

ID do colaborador associado ao número virtual.

namestring nullable

Nome do número virtual. Utilize para facilitar a gestão dos números virtuais.

costCenterstring nullable

Centro de custo associado ao número virtual.

areaCodenumber required

Código de área (DDD) associado ao número virtual.

Example request

{
  "employeeId": "0140a8c6-3815-45b7-9e60-8e137cad845c",
  "name": "Meu Número Virtual",
  "costCenter": "marketing",
  "areaCode": 11,
  "customFields": [
    {
      "label": "Departamento",
      "value": "Vendas"
    }
  ]
}

Response

idstring required

A valid UUID string, in any version.

namestring nullable required

Nome do número virtual. Utilize para facilitar a gestão dos números virtuais.

phoneNumberstring required

Número virtual recém-criado, formatado conforme o padrão internacional E.164.

status'pending' | 'active' | 'blocked' | 'canceled' required

createdAtstring date-time required

canceledAtstring date-time nullable required

cancelReasonstring nullable required

costCenterstring nullable required

Centro de custo associado ao número virtual.

employeeIdstring nullable required

A valid UUID string, in any version.

Example response

{
  "id": "0140a8c6-3815-45b7-9e60-8e137cad845c",
  "name": "Meu Número Virtual",
  "phoneNumber": "+551151231234",
  "costCenter": "marketing",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.