Integrações comuns (n8n, Zapier, Make)
JSONs prontos para importar e criar um card no board com nome, e-mail e telefone.
Receitas prontas para conectar ferramentas no-code à Perpetuus API. Todas usam o mesmo endpoint canônico:
POST https://api.perpetuus.com.br/api/boards/{boardId}/cards
Antes de importar:
- Gere um token de API
- Anote o slug da organização (
x-tenant-id) e o documentId do board - Substitua
SEU_TOKEN,acmeeSEU_BOARD_IDnos JSONs abaixo
Payload base (criar card)
Body — criar card
create-card.body.json
{
"data": {
"fields": {
"name": "Lead via integração",
"email": "lead@cliente.com",
"phone": "+5511999999999"
},
"description": "Criado via n8n / Zapier / Make",
"tags": ["origem-integracao"]
}
}n8n — workflow importável
No n8n: ⋯ → Import from File/URL e cole o JSON. Depois edite as credenciais no nó HTTP Request.
Workflow n8n — criar card
perpetuus-create-card.n8n.json
{
"name": "Perpetuus — Criar card no board",
"nodes": [
{
"parameters": {},
"id": "trigger",
"name": "Manual Trigger",
"type": "n8n-nodes-base.manualTrigger",
"typeVersion": 1,
"position": [0, 0]
},
{
"parameters": {
"method": "POST",
"url": "https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/cards",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{ "name": "Authorization", "value": "Bearer SEU_TOKEN" },
{ "name": "x-tenant-id", "value": "acme" },
{ "name": "Content-Type", "value": "application/json" }
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\n \"data\": {\n \"fields\": {\n \"name\": \"Lead via n8n\",\n \"email\": \"lead@cliente.com\",\n \"phone\": \"+5511999999999\"\n },\n \"description\": \"Lead via n8n\",\n \"tags\": [\"origem-n8n\"]\n }\n}",
"options": {}
},
"id": "http",
"name": "Criar card Perpetuus",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [280, 0]
}
],
"connections": {
"Manual Trigger": {
"main": [[{ "node": "Criar card Perpetuus", "type": "main", "index": 0 }]]
}
},
"active": false,
"settings": { "executionOrder": "v1" },
"tags": [{ "name": "perpetuus" }]
}Make — módulo HTTP
No Make: cenário → HTTP → Make a request. Use este JSON como espelho dos campos.
Make — HTTP Make a request
perpetuus-create-card.make.json
{
"module": "http:ActionSendData",
"version": 3,
"parameters": {
"url": "https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/cards",
"method": "POST",
"headers": [
{ "name": "Authorization", "value": "Bearer SEU_TOKEN" },
{ "name": "x-tenant-id", "value": "acme" },
{ "name": "Content-Type", "value": "application/json" }
],
"bodyType": "raw",
"contentType": "application/json",
"body": {
"data": {
"fields": {
"name": "{{1.name}}",
"email": "{{1.email}}",
"phone": "{{1.phone}}"
},
"description": "Lead via Make",
"tags": ["origem-make"]
}
},
"parseResponse": true
},
"notes": "Substitua SEU_BOARD_ID, SEU_TOKEN e acme. Mapeie name/email/phone do módulo anterior."
}Zapier — Custom Request
No Zapier: Webhooks by Zapier → Custom Request.
Zapier — Custom Request
perpetuus-create-card.zapier.json
{
"method": "POST",
"url": "https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/cards",
"data_pass_through": false,
"headers": {
"Authorization": "Bearer SEU_TOKEN",
"x-tenant-id": "acme",
"Content-Type": "application/json"
},
"data": {
"data": {
"fields": {
"name": "{{nome_do_lead}}",
"email": "{{email}}",
"phone": "{{telefone}}"
},
"description": "Lead via Zapier",
"tags": ["origem-zapier"]
}
},
"unflatten": true
}Headers comuns
| Header | Valor |
|---|---|
Authorization | Bearer SEU_TOKEN |
x-tenant-id | slug da organização |
Content-Type | application/json |