Reference
API Reference
REST sobre HTTPS, JSON in/out, Bearer token. Cada recurso tem páginas próprias com todos os endpoints, schemas e exemplos.
Base URL
https://api.usemix.app/api/v1AutenticaçãoAuthorization: Bearer manu_<token>Rate limit300 req / minuto / tokenFormatoJSON · UTF-8Recursos disponíveis
Clique em qualquer card pra ver todos os endpoints e schemas.
/people
People
Pessoas, leads e contatos. Vinculam-se a uma Company opcional e a um Owner (User do workspace).
/companies
Companies
Empresas e organizações. Agregam Pessoas e Deals.
/deals
Deals
Negócios em pipelines. Têm valor monetário, stage atual e responsável.
/activities
Activities
Tarefas, ligações, e-mails e reuniões vinculadas a qualquer objeto. Mutações pós-criação acontecem via UI.
/notes
Notes
Anotações em formato livre vinculadas a People, Companies ou Deals. Mutações pós-criação acontecem via UI.
Convenções
- IDs são UUIDs v4. Sempre passe e armazene como string.
- Datas em ISO 8601. Times sem timezone são tratados como UTC. Pra comparações precisas, use sempre `Z` ou offset explícito.
- Soft-delete. DELETE marca
deletedAtmas o objeto desaparece das listagens. Reversível via suporte em até 30 dias. - PATCH é merge raso. Envie só os campos que muda.
customFieldstambém é merge raso — pra remover um custom field, envienull. - Multi-tenancy é transparente. Seu token está vinculado a um workspace; não há header
X-Tenant-Idnem nada do tipo.
Ordem de leitura recomendada
- Quickstart — primeira chamada e primeiro deal em 5 minutos.
- Autenticação — scopes granulares e rotação.
- People e Deals — os dois recursos mais usados.
- Webhooks — receba mudanças em tempo real e pare de pollar.