Skip to main content
POST
/
api
/
v1
/
webhooks
curl -X POST 'https://app.plowf.com/api/v1/webhooks' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://webhook.site/04ef5e41-d054-49f9-805c-03a6a345245e",
    "token": "nUeO7RobnrgJxs8mBr1oOvChV4wqOblj"
  }'

{
  "data": {
    "uuid": "e1afe0f4-9358-4a50-b0fd-55912ca86ee1",
    "url": "https://webhook.site/04ef5e41-d054-49f9-805c-03a6a345245e",
    "token": "nUeO7RobnrgJxs8mBr1oOvChV4wqOblj",
    "status": "ACTIVE",
    "events": [
      "PAYMENT",
      "TRANSFER",
      "REFUND",
      "MED",
      "PIX_TRANSACTION"
    ],
    "created_at": "2026-01-13T00:37:47.000000Z"
  }
}
Cria um novo webhook para receber notificações de eventos da plataforma. 
curl -X POST 'https://app.plowf.com/api/v1/webhooks' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://webhook.site/04ef5e41-d054-49f9-805c-03a6a345245e",
    "token": "nUeO7RobnrgJxs8mBr1oOvChV4wqOblj"
  }'

​
Body Parameters

​
url
string
required
URL do endpoint que receberá os webhooks. Deve ser uma URL válida e acessível via HTTPS.
​
token
string
Token opcional para autenticação dos webhooks. Se não informado, será gerado automaticamente. Este token será usado para validar a assinatura HMAC dos webhooks recebidos.
​
events
array
Eventos que serão enviados para o endpoint. Se não informado, serão enviados todos os eventos.

​
Validações

  • url deve ser uma URL válida e acessível via HTTPS
  • url é obrigatório
  • token é opcional. Se não informado, será gerado automaticamente
  • events é opcional. Se não informado, serão enviados todos os eventos

​
Resposta de Sucesso

A resposta retorna o objeto do webhook criado com o token gerado (ou o token informado). 
{
  "data": {
    "uuid": "e1afe0f4-9358-4a50-b0fd-55912ca86ee1",
    "url": "https://webhook.site/04ef5e41-d054-49f9-805c-03a6a345245e",
    "token": "nUeO7RobnrgJxs8mBr1oOvChV4wqOblj",
    "status": "ACTIVE",
    "events": [
      "PAYMENT",
      "TRANSFER",
      "REFUND",
      "MED",
      "PIX_TRANSACTION"
    ],
    "created_at": "2026-01-13T00:37:47.000000Z"
  }
}
​
data
object
Dados do webhook criado
Guarde o token retornado com segurança. Ele será necessário para validar a assinatura HMAC dos webhooks recebidos. Se você não informou um token, o sistema gerou um automaticamente.

​
Erros Comuns