Pular para o conteúdo principal
POST
/
api
/
v1
/
calendars
/
{calendar_id}
/
events
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/events" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Demo with Acme",
    "start_at": "2024-01-20T15:00:00Z",
    "end_at": "2024-01-20T15:30:00Z",
    "type": "meeting",
    "attendees": [{"name":"Jane Doe","email":"[email protected]"}]
  }'

{
  "success": true,
  "data": {
    "id": "event-uuid-1",
    "calendar_id": "calendar-uuid-1",
    "title": "Demo with Acme",
    "start_at": "2024-01-20T15:00:00Z",
    "end_at": "2024-01-20T15:30:00Z",
    "status": "confirmed",
    "type": "meeting"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

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

​
Criar Evento de Calendário

Criar um novo evento em um calendário.

​
Endpoint

POST /api/v1/calendars/{calendar_id}/events

​
Parâmetros de Caminho

​
calendar_id
string
obrigatório
UUID do calendário.

​
Cabeçalhos da Requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
​
Content-Type
string
obrigatório
Deve ser application/json.

​
Corpo da Requisição

​
title
string
obrigatório
Título do evento.
​
description
string
Descrição opcional.
​
start_at
string
obrigatório
Horário de início. ISO 8601.
​
end_at
string
obrigatório
Horário de término. ISO 8601. Deve ser posterior a start_at.
​
status
string
Opções: confirmed, tentative, cancelled. Padrão: confirmed.
​
type
string
Tag livre de tipo de evento (ex: meeting, block, appointment).
​
created_by
string
UUID do usuário criador.
​
owner_id
string
UUID do proprietário (usuário ou agente).
​
owner_type
string
Tipo do proprietário. Opções: user, agent.
​
attendees
array
Array de objetos { name, email }.

​
Exemplos

curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/events" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Demo with Acme",
    "start_at": "2024-01-20T15:00:00Z",
    "end_at": "2024-01-20T15:30:00Z",
    "type": "meeting",
    "attendees": [{"name":"Jane Doe","email":"[email protected]"}]
  }'

​
Resposta

{
  "success": true,
  "data": {
    "id": "event-uuid-1",
    "calendar_id": "calendar-uuid-1",
    "title": "Demo with Acme",
    "start_at": "2024-01-20T15:00:00Z",
    "end_at": "2024-01-20T15:30:00Z",
    "status": "confirmed",
    "type": "meeting"
  }
}