Endpoint: POST /event/seller/{account_id}/events/
Autenticação: JWT obrigatório ou Chave de API aceita Cria um evento pertencente a {account_id}. Dependendo do type, um bloco de address (endereço físico) ou digital_address (endereço digital) é obrigatório. A description do evento é sanitizada no servidor para remover HTML malicioso antes da persistência.

​
Pré-requisitos

  • O token deve operar a {account_id} (conta unificada).
  • Para eventos IN_PERSON, o bloco address é obrigatório. Para eventos ONLINE, o bloco digital_address é obrigatório.

​
Parâmetros de caminho

​
account_id
string (uuid)
required
Conta unificada que será dona do evento.

​
Corpo da requisição

​
name
string
required
Até 100 caracteres.
​
description
string
required
Descrição completa. HTML é permitido — sanitizado no servidor.
​
type
string
required
IN_PERSON ou ONLINE.
​
image_url
string
required
URL da imagem de capa/banner (até 256 caracteres).
​
subject
string
required
Código do assunto.
​
category
string
required
Código da categoria.
​
nomenclature
string
required
TICKETING, REGISTRATION ou CONTRIBUTION.
​
public
boolean
Padrão true.
​
max_installments
string
Limite máximo de parcelas, "1".."12". Padrão "12". Controla o teto aplicado aos checkouts.
​
max_installments_no_tax
string
Quantidade de parcelas sem juros repassadas ao comprador, "0".."12". "0" significa que sempre há juros (e a sobretaxa também se aplica ao PIX). Padrão "0".
​
starts_at
string (datetime)
required
​
ends_at
string (datetime)
required
​
address
object
Obrigatório quando type é IN_PERSON. Campos: name, display_map_widget, neighborhood, city, state, postal_code, country_code, street, number, complement.
​
digital_address
object
Obrigatório quando type é ONLINE. Campos: platform (um dos valores GOOGLE_MEET, MICROSOFT_TEAMS, ZOOM, YOUTUBE, FACEBOOK, INSTAGRAM, WHATSAPP, DEFINE_LATER, OTHER), other_platform, url.

​
Resposta

201 Created com o evento criado. Mesmo formato do endpoint de detalhe. 
{
  "id": "1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111",
  "type": "IN_PERSON",
  "name": "Festival Sunset 2026",
  "description": "Edição de aniversário.",
  "public": true,
  "max_installments": "12",
  "max_installments_no_tax": "3",
  "image_url": "https://cdn.dlpay.cloud/events/sunset.jpg",
  "subject": "27",
  "category": "39",
  "nomenclature": "TICKETING",
  "link": "https://eventos.exemplo.com.br/evento/festival-sunset-2026/1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111",
  "starts_at": "2026-08-12T22:00:00Z",
  "ends_at": "2026-08-13T06:00:00Z",
  "address": {
    "name": "Arena Sunset",
    "display_map_widget": true,
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "postal_code": "01001-000",
    "country_code": "BR",
    "street": "Av. Paulista",
    "number": "1000",
    "complement": ""
  },
  "digital_address": null,
  "created_at": "2026-05-14T12:00:00Z",
  "updated_at": "2026-05-14T12:00:00Z"
}

​
Erros

StatusQuando
400address/digital_address faltando para o tipo do evento, opções inválidas, conta não encontrada.
401Token ausente ou inválido.

​
Ações relacionadas

  • POST /event/seller/{account_id}/events/upload_logo/ — upload multipart para a imagem de capa do evento. Campo file (até 2 MB, formatos image/jpeg, png, jpg, gif, webp). Retorna {"url": "<public_url>"} para uso em image_url.

​
Exemplos

curl -X POST "https://api.dlpay.cloud/event/seller/$ACCOUNT_ID/events/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Festival Sunset 2026",
    "description": "Edição de aniversário.",
    "type": "IN_PERSON",
    "image_url": "https://cdn.dlpay.cloud/events/sunset.jpg",
    "subject": "27",
    "category": "39",
    "nomenclature": "TICKETING",
    "max_installments": "12",
    "max_installments_no_tax": "3",
    "starts_at": "2026-08-12T22:00:00Z",
    "ends_at": "2026-08-13T06:00:00Z",
    "address": {
      "name": "Arena Sunset",
      "display_map_widget": true,
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01001-000",
      "country_code": "BR",
      "street": "Av. Paulista",
      "number": "1000",
      "complement": ""
    }
  }'