Criar instância

Amb. de Produção

https://api.way-api.io

POST

/instances

Última modificação:2026-09-17 22:00:23

Cria uma instância desconectada.

A instância representa uma conta do WhatsApp. Guarde o instanceId retornado, pois ele será usado
nas rotas de conexão, mensagens e webhooks. Depois, conecte-a com
POST /instances/{instanceId}/connect.

Requisição

Authorization

Adicionar parâmetro em header

x-api-key

Exemplo:

x-api-key: ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Dados da instância criada.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.way-api.io/instances' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Atendimento Principal"
}'

Response Example

201 - Instância criada

{
    "instanceId": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4c",
    "name": "Atendimento Principal",
    "status": "disconnected",
    "createdAt": "2026-04-23T12:30:00.000Z"
}

Modificado em 2026-09-17 22:00:23

Página anterior

Listar instâncias

Próxima página

Atualizar nome da instância