> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thatsme.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar um ou mais eventos



## OpenAPI

````yaml /openapi.json post /v1.0/events
openapi: 3.0.3
info:
  title: That's Me API
  version: '1.0'
  description: >-
    API pública da That's Me — emita certificados digitais, consulte eventos e
    analytics via API.
servers:
  - url: https://api.thatsme.com.br/api
    description: Produção
  - url: https://servicetest.thatsme.com.br/api
    description: Sandbox
security: []
tags:
  - name: Emissões
    description: Emitir certificados e gerenciar destinatários
  - name: Eventos
    description: Criar e gerenciar eventos
  - name: Badges
    description: Gerenciar badges/TMs
  - name: Saldo
    description: Consultar saldo de emissões
  - name: Dashboard
    description: Analytics e exportação de dados
  - name: Webhooks
    description: Configurar notificações em tempo real
  - name: API Keys
    description: Gerenciar chaves de API
  - name: Verificação
    description: Verificar autenticidade de certificados
paths:
  /v1.0/events:
    post:
      tags:
        - Eventos
      summary: Criar um ou mais eventos
      operationId: createEvent
      requestBody:
        required: true
        description: Objeto com os atributos de um evento ou array de eventos
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEventsBodyDto'
      responses:
        '201':
          description: Evento(s) criado(s) com sucesso
        '400':
          description: Dados inválidos
        '401':
          description: API Key inválida
        '403':
          description: Acesso negado
      security:
        - bearerAuth: []
components:
  schemas:
    CreateEventsBodyDto:
      type: object
      required:
        - events
      properties:
        events:
          type: array
          items:
            $ref: '#/components/schemas/CreateEventDto'
          minItems: 1
          description: Um evento ou array de eventos para criação
    CreateEventDto:
      type: object
      required:
        - name
        - description
        - category
        - location_type
      properties:
        name:
          type: string
          description: Nome do evento
        description:
          type: string
          description: Descrição do evento
        category:
          type: string
          enum:
            - SPORTS
            - EDUCATION
            - CORPORATE
            - SOCIOCULTURAL
          description: Categoria do evento
        location_type:
          type: string
          enum:
            - PHYSICAL
            - ONLINE
          description: Tipo de localização do evento
        state:
          type: string
          description: >-
            State or province of the event (e.g., 'SP', 'CA', 'Bayern').
            Required when location_type is PHYSICAL.
          nullable: true
        city:
          type: string
          description: City of the event. Required when location_type is PHYSICAL.
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code (e.g., 'BR', 'US', 'DE').
          nullable: true
        latitude:
          type: number
          description: Latitude of the event location.
          nullable: true
        longitude:
          type: number
          description: Longitude of the event location.
          nullable: true
        timezone:
          type: string
          description: >-
            IANA timezone identifier (e.g., 'America/Sao_Paulo',
            'Europe/Berlin').
          nullable: true
        address:
          type: string
          description: Full formatted address of the event location.
          nullable: true
        initial_date:
          type: string
          description: >-
            Data de início em formato ISO 8601. Salva em dd/mm/aaaa. Obrigatório
            para date_mode SINGLE_DATE ou DATE_RANGE.
        finish_date:
          type: string
          description: >-
            Data de término em formato ISO 8601. Salva em dd/mm/aaaa.
            Obrigatório para date_mode DATE_RANGE.
        official_url:
          type: string
          description: URL oficial do evento
        image_url:
          type: string
          description: URL da imagem do evento
        image_key:
          type: string
          description: Chave da imagem do evento (S3)
        is_private:
          type: boolean
          description: Define se o evento é privado
        date_mode:
          type: string
          enum:
            - SINGLE_DATE
            - DATE_RANGE
            - RECURRING
            - ALWAYS_AVAILABLE
          description: Modo de datas do evento
        start_time:
          type: string
          description: Horário de início do evento (quando aplicável)
        end_time:
          type: string
          description: Horário de término do evento (quando aplicável)
        recurrence_type:
          type: string
          enum:
            - WEEKLY
            - BIWEEKLY
            - MONTHLY
            - BIMONTHLY
            - QUARTERLY
            - SEMIANNUAL
            - ANNUAL
          description: Tipo de recorrência. Obrigatório para date_mode RECURRING.
        recurrence_start_date:
          type: string
          description: >-
            Data de início da recorrência em formato ISO 8601. Salva em
            dd/mm/aaaa. Obrigatório para date_mode RECURRING.
        connected_event_ids:
          type: array
          items:
            type: string
          description: Lista de IDs de eventos conectados
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY

````