Criar evento

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

string (uuid)

required

Conta unificada que será dona do evento.

Corpo da requisição

string

required

Até 100 caracteres.

string

required

Descrição completa. HTML é permitido — sanitizado no servidor.

string

required

IN_PERSON ou ONLINE.

string

required

URL da imagem de capa/banner (até 256 caracteres).

string

required

Código do assunto.

string

required

Código da categoria.

string

required

TICKETING, REGISTRATION ou CONTRIBUTION.

boolean

Padrão true.

string

Limite máximo de parcelas, "1".."12". Padrão "12". Controla o teto aplicado aos checkouts.

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".

string (datetime)

required

string (datetime)

required

object

Obrigatório quando type é IN_PERSON. Campos: name, display_map_widget, neighborhood, city, state, postal_code, country_code, street, number, complement.

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

Status	Quando
`400`	`address`/`digital_address` faltando para o tipo do evento, opções inválidas, conta não encontrada.
`401`	Token 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": ""
    }
  }'

import requests

response = requests.post(
    f"https://api.dlpay.cloud/event/seller/{account_id}/events/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={
        "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": "",
        },
    },
)
event = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/event/seller/${accountId}/events/`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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: "",
      },
    }),
  },
);
const event = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Pré-requisitos

Parâmetros de caminho

Corpo da requisição

Resposta

Erros

Ações relacionadas

Exemplos

​Pré-requisitos

​Parâmetros de caminho

​Corpo da requisição

​Resposta

​Erros

​Ações relacionadas

​Exemplos

Pré-requisitos

Parâmetros de caminho

Corpo da requisição

Resposta

Erros

Ações relacionadas

Exemplos