Skip to main content
POST
/
consents
/
batch
Batch create consents (up to 1000 rows)
curl --request POST \
  --url https://www.consentfly.com.br/api/v1/consents/batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "consents": [
    {
      "site_id": "6b8b4567-327a-4d10-92a5-9e8c4f5a7d12",
      "subject_id": "user_sha256_a1b2c3d4e5f6",
      "consent_id": "analytics-2026-05",
      "accepted": true,
      "preferences": {
        "analytics": true,
        "marketing": false,
        "functional": true
      },
      "policy_version": 3,
      "ip_address": "200.150.100.50",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/605.1.15"
    }
  ]
}
'
{
  "created": 998,
  "failed": 1,
  "skipped_quota": 1,
  "results": [
    {
      "index": 0,
      "status": "created",
      "error": "",
      "consent": {
        "id": "01HK8VV4P9R3T8M2A2YZJ7HQ5Q",
        "site_id": "6b8b4567-327a-4d10-92a5-9e8c4f5a7d12",
        "subject_id": "user_sha256_a1b2c3d4e5f6",
        "consent_id": "analytics-2026-05",
        "accepted": true,
        "preferences": {
          "analytics": true,
          "marketing": false,
          "functional": true
        },
        "policy_version": 3,
        "country": "BR",
        "region": "SP",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/605.1.15",
        "created_at": "2026-05-24T10:30:00Z",
        "updated_at": "2026-05-24T10:30:00Z",
        "deleted_at": null
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.consentfly.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Autenticação por API Key no formato Authorization: Bearer sk-... (sempre inclua o prefixo Bearer).

Gere sua chave em /dashboard/api-keys após criar a conta e verificar o e-mail. A chave é exibida uma única vez no momento da criação — armazene em variável de ambiente no seu backend. Nunca exponha em código client-side.

Body

application/json

Up to 1000 consent rows

Lote de consentimentos para ingestão em batch (até 1000 por chamada).

​
consents
object[]
required
Required array length: 1 - 1000 elements

Response

Batch processed (per-row status array)

Resultado da ingestão em batch, com status por linha.

​
created
integer

Quantos consentimentos foram criados com sucesso.

Example:

998

​
failed
integer

Quantos falharam por validação ou erro do servidor.

Example:

1

​
skipped_quota
integer

Quantos foram puladas por estouro de cota mensal.

Example:

1

​
results
object[]

Status individual de cada linha do lote, na mesma ordem da requisição.