API do CRM Oficina Martech
Integre seu produto ao CRM via endpoints REST autenticados por Bearer API key.
A API do CRM Oficina Martech permite ler e operar dados da sua organização — contatos, mensagens, conversas, formulários — de qualquer aplicação externa. Autenticação por Bearer API key com escopos granulares.
Status atual: Beta. 8 operações públicas em 6 paths documentadas na especificação OpenAPI (GET/POST /contacts, GET /contacts/{id}, GET /contacts/message-search, GET/POST /deals, GET /deals/{id} e POST /messages/send). Escopos e contratos devem ser conferidos na referência e no OpenAPI.
Por onde começar
Começar em 5 minutos
Crie uma API key, faça a primeira chamada, leia a resposta.
Referência da API
Endpoints, parâmetros, schemas e códigos de erro.
Guias por caso de uso
Autenticação, paginação, retry, casos práticos.
Roadmap
O que está em desenvolvimento e o que está sob avaliação.
O que você precisa
- Uma conta ativa no CRM Oficina Martech
- Permissão de owner ou admin na organização (para criar API keys)
- Familiaridade básica com REST e Bearer authentication
Convenções
- Base URL de produção (canônica):
https://crm.oficinamartech.com/api/v1 - Autenticação: header
Authorization: Bearer <sua-api-key> - Identificadores: UUIDs v4 (ex:
f47ac10b-58cc-4372-a567-0e02b2c3d479) - Datas: ISO 8601 com timezone (ex:
2026-05-20T13:24:00.000Z) - Encoding: UTF-8 em todas as requisições e respostas
- Paginação: cursores via
limiteoffset(veja Paginação)