scheduling.schedules_create

Criar agenda. Cria uma agenda. Dono: attendantId (ou memberId, o mesmo id) para individual/group, ou teamId para round_robin (padrão quando só há teamId); sem dono invalid_input. duration 5 a 480 min (padrão 30). slug (3 a 48 letras minúsculas, números e hífen, único na conta) é gerado do nome quando a agenda é pública e ele vem vazio. bookingFields são as perguntas do formulário (field: name, email, secondaryEmail, telephone, whatsappNumber, instagram, linkedin, twitterX, tiktok, youtube, observations, city, state, document, birthday ou custom + customFieldId; nome e e-mail são sempre obrigatórios). meetingLocationMode: clickmax_meet, google_meet (padrão), attendant_room ou fixed_link (exige meetingLocationUrl http/https). Agenda group exige groupCapacity (1 a 100) e sessionRules (dia da semana + HH:mm que cabe no mesmo dia). bufferMinutes (intervalo), minNoticeMinutes, maxAdvanceDays, maxBookingsPerDay e maxBookingsPerMemberPerDay limitam os horários. memberCalendars define quem do time participa (vazio = todo o time). Com isPublic, valem também confirmação, botões, redirecionamento, pixel e verificação por código. rollingWindow* é só gravado (a janela rolante ainda não afeta os horários). Exige a migration de agendas (migration_pendente sem ela).

Endpoint: POST https://app.atomiks.com.br/api/v1/scheduling.schedules_create (corpo JSON)
Quem pode chamar: administrador da conta
Escopo da chave: crm:write
Grava dados: sim
Pela chave de API: sim
Ferramenta MCP: scheduling_schedules_create
Ficha em JSON: https://app.atomiks.com.br/api/v1/openapi.json (operationId scheduling.schedules_create)

Entrada

Campo	Tipo	Obrigatório	Nota
`name`	string	sim
`description`	string \| null	não
`duration`	integer	não	padrão 30
`color`	string \| null	não
`isPublic`	boolean	não	padrão false
`slug`	string	não
`pipelineId`	string (uuid) \| null	não
`stageId`	string (uuid) \| null	não
`bufferMinutes`	integer	não	padrão 0
`minNoticeMinutes`	integer	não	padrão 0
`maxBookingsPerDay`	integer \| null	não
`maxBookingsPerMemberPerDay`	integer \| null	não
`maxAdvanceDays`	integer \| null	não
`rollingWindowEnabled`	boolean	não
`rollingWindowThresholdPercent`	integer	não
`rollingWindowStepDays`	integer	não
`confirmationMessage`	string \| null	não
`bookingFields`	object[] \| null	não
`confirmationButtons`	object[] \| null	não
`redirectUrl`	string \| null	não
`pixelId`	string \| null	não
`redirectDelaySeconds`	integer \| null	não
`emailLayoutTemplateId`	string \| null	não
`otpVerificationEnabled`	boolean	não
`otpChannel`	"email" \| "whatsapp"	não
`otpEmailSenderSignatureId`	string \| null	não
`otpWhatsappTemplateId`	string \| null	não
`meetingLocationMode`	"clickmax_meet" \| "google_meet" \| "attendant_room" \| "fixed_link"	não
`meetingLocationUrl`	string \| null	não
`meetPlaybookId`	string \| null	não
`meetCopilotAgentId`	string \| null	não
`groupCapacity`	integer	não
`groupShowSeatsLeft`	boolean	não
`sessionRules`	object[]	não
`schedulingType`	"individual" \| "group" \| "round_robin"	não
`attendantId`	string (uuid) \| null	não
`memberId`	string (uuid) \| null	não
`teamId`	string (uuid) \| null	não
`memberCalendars`	object[]	não

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "duration": {
      "default": 30,
      "type": "integer",
      "minimum": 5,
      "maximum": 480
    },
    "color": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^#[0-9a-fA-F]{6}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "isPublic": {
      "default": false,
      "type": "boolean"
    },
    "slug": {
      "type": "string",
      "maxLength": 48
    },
    "pipelineId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "stageId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "bufferMinutes": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 1440
    },
    "minNoticeMinutes": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 525600
    },
    "maxBookingsPerDay": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000
        },
        {
          "type": "null"
        }
      ]
    },
    "maxBookingsPerMemberPerDay": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000
        },
        {
          "type": "null"
        }
      ]
    },
    "maxAdvanceDays": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 365
        },
        {
          "type": "null"
        }
      ]
    },
    "rollingWindowEnabled": {
      "type": "boolean"
    },
    "rollingWindowThresholdPercent": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "rollingWindowStepDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "confirmationMessage": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ]
    },
    "bookingFields": {
      "anyOf": [
        {
          "maxItems": 40,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string",
                "enum": [
                  "name",
                  "email",
                  "secondaryEmail",
                  "telephone",
                  "whatsappNumber",
                  "instagram",
                  "linkedin",
                  "twitterX",
                  "tiktok",
                  "youtube",
                  "observations",
                  "city",
                  "state",
                  "document",
                  "birthday",
                  "custom"
                ]
              },
              "required": {
                "type": "boolean"
              },
              "customFieldId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "field",
              "required"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "confirmationButtons": {
      "anyOf": [
        {
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "label": {
                "type": "string",
                "maxLength": 100
              },
              "type": {
                "type": "string",
                "enum": [
                  "link",
                  "whatsapp",
                  "email",
                  "download"
                ]
              },
              "value": {
                "type": "string",
                "maxLength": 2000
              },
              "variant": {
                "default": "primary",
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              }
            },
            "required": [
              "id",
              "label",
              "type",
              "value"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "redirectUrl": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "pixelId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "redirectDelaySeconds": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 60
        },
        {
          "type": "null"
        }
      ]
    },
    "emailLayoutTemplateId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "otpVerificationEnabled": {
      "type": "boolean"
    },
    "otpChannel": {
      "type": "string",
      "enum": [
        "email",
        "whatsapp"
      ]
    },
    "otpEmailSenderSignatureId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "otpWhatsappTemplateId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "meetingLocationMode": {
      "type": "string",
      "enum": [
        "clickmax_meet",
        "google_meet",
        "attendant_room",
        "fixed_link"
      ]
    },
    "meetingLocationUrl": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "meetPlaybookId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "meetCopilotAgentId": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "groupCapacity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "groupShowSeatsLeft": {
      "type": "boolean"
    },
    "sessionRules": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dayOfWeek": {
            "type": "integer",
            "minimum": 0,
            "maximum": 6
          },
          "startTime": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          }
        },
        "required": [
          "dayOfWeek",
          "startTime"
        ]
      }
    },
    "schedulingType": {
      "type": "string",
      "enum": [
        "individual",
        "group",
        "round_robin"
      ]
    },
    "attendantId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "memberId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "teamId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "memberCalendars": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "attendantId": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "externalCalendarIds": {
            "default": [],
            "maxItems": 50,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        },
        "required": [
          "attendantId"
        ]
      }
    }
  },
  "required": [
    "name"
  ]
}

Exemplo

curl -X POST https://app.atomiks.com.br/api/v1/scheduling.schedules_create \
  -H "Authorization: Bearer $ATOMIKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Reunião de apresentação","duration":30,"bufferMinutes":0,"minNoticeMinutes":0,"attendantId":"00000000-0000-0000-0000-000000000000","isPublic":true}'

CLI:

node cli/atomiks.mjs scheduling.schedules_create --json '{"name":"Reunião de apresentação","duration":30,"bufferMinutes":0,"minNoticeMinutes":0,"attendantId":"00000000-0000-0000-0000-000000000000","isPublic":true}'

MCP: ferramenta scheduling_schedules_create com a mesma entrada.

Saída

Sucesso: {"data": ...} com o formato abaixo.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "slug": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "duration": {
      "type": "number"
    },
    "color": {
      "type": [
        "string",
        "null"
      ]
    },
    "isPublic": {
      "type": "boolean"
    },
    "isPersonal": {
      "type": "boolean"
    },
    "schedulingType": {
      "type": "string",
      "enum": [
        "individual",
        "group",
        "round_robin"
      ]
    },
    "attendantId": {
      "type": [
        "string",
        "null"
      ]
    },
    "memberId": {
      "type": [
        "string",
        "null"
      ]
    },
    "attendantName": {
      "type": [
        "string",
        "null"
      ]
    },
    "teamId": {
      "type": [
        "string",
        "null"
      ]
    },
    "teamName": {
      "type": [
        "string",
        "null"
      ]
    },
    "teamColor": {
      "type": [
        "string",
        "null"
      ]
    },
    "pipelineId": {
      "type": [
        "string",
        "null"
      ]
    },
    "stageId": {
      "type": [
        "string",
        "null"
      ]
    },
    "bufferMinutes": {
      "type": "number"
    },
    "minNoticeMinutes": {
      "type": "number"
    },
    "maxBookingsPerDay": {
      "type": [
        "number",
        "null"
      ]
    },
    "maxBookingsPerMemberPerDay": {
      "type": [
        "number",
        "null"
      ]
    },
    "maxAdvanceDays": {
      "type": [
        "number",
        "null"
      ]
    },
    "rollingWindowEnabled": {
      "type": "boolean"
    },
    "rollingWindowThresholdPercent": {
      "type": "number"
    },
    "rollingWindowStepDays": {
      "type": "number"
    },
    "confirmationMessage": {
      "type": [
        "string",
        "null"
      ]
    },
    "bookingFields": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "customFieldId": {
            "type": "string"
          }
        },
        "required": [
          "field",
          "required"
        ],
        "additionalProperties": false
      }
    },
    "confirmationButtons": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "value": {
                "type": "string"
              },
              "variant": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "label",
              "type",
              "value",
              "variant"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "redirectUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "pixelId": {
      "type": [
        "string",
        "null"
      ]
    },
    "redirectDelaySeconds": {
      "type": [
        "number",
        "null"
      ]
    },
    "emailLayoutTemplateId": {
      "type": [
        "string",
        "null"
      ]
    },
    "otpVerificationEnabled": {
      "type": "boolean"
    },
    "otpChannel": {
      "type": "string",
      "enum": [
        "email",
        "whatsapp"
      ]
    },
    "otpEmailSenderSignatureId": {
      "type": [
        "string",
        "null"
      ]
    },
    "otpWhatsappTemplateId": {
      "type": [
        "string",
        "null"
      ]
    },
    "meetingLocationMode": {
      "type": "string",
      "enum": [
        "clickmax_meet",
        "google_meet",
        "attendant_room",
        "fixed_link"
      ]
    },
    "meetingLocationUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "meetPlaybookId": {
      "type": [
        "string",
        "null"
      ]
    },
    "meetCopilotAgentId": {
      "type": [
        "string",
        "null"
      ]
    },
    "memberCalendars": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "attendantId": {
            "type": "string"
          },
          "externalCalendarIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "attendantId",
          "externalCalendarIds"
        ],
        "additionalProperties": false
      }
    },
    "groupCapacity": {
      "type": "number"
    },
    "groupShowSeatsLeft": {
      "type": "boolean"
    },
    "sessionRules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dayOfWeek": {
            "type": "integer",
            "minimum": 0,
            "maximum": 6
          },
          "startTime": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
          }
        },
        "required": [
          "dayOfWeek",
          "startTime"
        ],
        "additionalProperties": false
      }
    },
    "publicPath": {
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "type": "string"
    },
    "updatedAt": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "name",
    "slug",
    "description",
    "duration",
    "color",
    "isPublic",
    "isPersonal",
    "schedulingType",
    "attendantId",
    "memberId",
    "attendantName",
    "teamId",
    "teamName",
    "teamColor",
    "pipelineId",
    "stageId",
    "bufferMinutes",
    "minNoticeMinutes",
    "maxBookingsPerDay",
    "maxBookingsPerMemberPerDay",
    "maxAdvanceDays",
    "rollingWindowEnabled",
    "rollingWindowThresholdPercent",
    "rollingWindowStepDays",
    "confirmationMessage",
    "bookingFields",
    "confirmationButtons",
    "redirectUrl",
    "pixelId",
    "redirectDelaySeconds",
    "emailLayoutTemplateId",
    "otpVerificationEnabled",
    "otpChannel",
    "otpEmailSenderSignatureId",
    "otpWhatsappTemplateId",
    "meetingLocationMode",
    "meetingLocationUrl",
    "meetPlaybookId",
    "meetCopilotAgentId",
    "memberCalendars",
    "groupCapacity",
    "groupShowSeatsLeft",
    "sessionRules",
    "publicPath",
    "createdAt",
    "updatedAt"
  ],
  "additionalProperties": false
}

Erros

{"error": {"code", "message", "requestId"}}. Códigos: invalid_input (400), unauthorized (401), forbidden / account_pending / scope_missing (403), not_found (404), limit_reached (409), internal (500).