# Objetos personalizados (`custom_objects.*`) Objetos do negócio (imóveis, veículos, contratos, turmas…): definição com nome, ícone, cor e gênero, campos com tipos, grupo, único, uso e quem preencheu, ligações com contatos, oportunidades, empresas e outros objetos (1 → vários ou vários ↔ vários), registros com responsável, vínculos, notas, histórico, visões salvas, filtros (inclusive por campos do outro lado de uma ligação: relation_filter_fields; operadores começa com e termina com), ações em massa, exportar e importar registros (CSV/TSV) e foto de campo (image_upload). Exportar, importar e ações em massa acima de 200 registros viram tarefas assíncronas: a operação devolve uma tarefa (jobId, state waiting), o worker processa em lotes e record_job_get/record_jobs_list mostram o progresso; a exportação pode avisar por e-mail (notifyEmail). Importar: records_import_upload_url devolve uma URL assinada para enviar o arquivo (até 100 MB, 100.000 linhas) e records_import recebe o uploadId com columnMappings, matchFieldId, conflictStrategy e responsibleAttendantId; records_import_ai_mapping e records_import_ai_column sugerem o mapeamento com IA (sem ANTHROPIC_API_KEY devolvem aiFailed e o mapeamento é por nome da coluna). Exigem o módulo de plano crm.custom-objects (fora do plano padrão; sem ele a resposta é forbidden) e uma migration (sem ela a escrita responde migration_pendente). Operações: 50. Todas são `POST https://app.atomiks.com.br/api/v1/`. - [`custom_objects.list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.list.md): Listar objetos personalizados (`crm:read`) - [`custom_objects.overview`](https://app.atomiks.com.br/docs/operacoes/custom_objects.overview.md): Visão geral dos objetos e ligações (`crm:read`) - [`custom_objects.get`](https://app.atomiks.com.br/docs/operacoes/custom_objects.get.md): Ver um objeto (`crm:read`) - [`custom_objects.create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.create.md): Criar objeto personalizado (`crm:write`) - [`custom_objects.update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.update.md): Editar objeto personalizado (`crm:write`) - [`custom_objects.archive`](https://app.atomiks.com.br/docs/operacoes/custom_objects.archive.md): Arquivar objeto (`crm:write`) - [`custom_objects.unarchive`](https://app.atomiks.com.br/docs/operacoes/custom_objects.unarchive.md): Desarquivar objeto (`crm:write`) - [`custom_objects.fields_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.fields_list.md): Listar campos de um objeto (`crm:read`) - [`custom_objects.field_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.field_create.md): Criar campo em um objeto (`crm:write`) - [`custom_objects.field_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.field_update.md): Editar campo de um objeto (`crm:write`) - [`custom_objects.fields_reorder`](https://app.atomiks.com.br/docs/operacoes/custom_objects.fields_reorder.md): Reordenar os campos de um objeto (`crm:write`) - [`custom_objects.field_insights`](https://app.atomiks.com.br/docs/operacoes/custom_objects.field_insights.md): Uso de um campo de objeto (`crm:read`) - [`custom_objects.field_records`](https://app.atomiks.com.br/docs/operacoes/custom_objects.field_records.md): Quem preencheu um campo de objeto (`crm:read`) - [`custom_objects.field_groups`](https://app.atomiks.com.br/docs/operacoes/custom_objects.field_groups.md): Grupos de campos de um objeto (`crm:read`) - [`custom_objects.fields_bulk_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.fields_bulk_update.md): Alterar vários campos de um objeto (`crm:write`) - [`custom_objects.relations_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.relations_list.md): Listar ligações dos objetos (`crm:read`) - [`custom_objects.relation_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.relation_create.md): Criar ligação de um objeto (`crm:write`) - [`custom_objects.relation_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.relation_update.md): Editar ligação (`crm:write`) - [`custom_objects.relation_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.relation_delete.md): Excluir ligação (`crm:write`) - [`custom_objects.access_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.access_list.md): Cargos e permissões de objetos (`crm:read`) - [`custom_objects.records_query`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_query.md): Listar registros de um objeto (`crm:read`) - [`custom_objects.relation_filter_fields`](https://app.atomiks.com.br/docs/operacoes/custom_objects.relation_filter_fields.md): Campos filtráveis do outro lado de uma ligação (`crm:read`) - [`custom_objects.records_search`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_search.md): Buscar registros de um objeto por título (`crm:read`) - [`custom_objects.record_get`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_get.md): Ver um registro (`crm:read`) - [`custom_objects.record_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_create.md): Criar registro de um objeto (`crm:write`) - [`custom_objects.record_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_update.md): Editar registro (`crm:write`) - [`custom_objects.record_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_delete.md): Excluir registro (`crm:write`) - [`custom_objects.records_bulk_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_bulk_delete.md): Excluir registros em massa (`crm:write`) - [`custom_objects.records_bulk_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_bulk_update.md): Alterar registros em massa (`crm:write`) - [`custom_objects.record_notes_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_notes_list.md): Listar notas de um registro (`crm:read`) - [`custom_objects.record_note_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_note_create.md): Criar nota em um registro (`crm:write`) - [`custom_objects.record_note_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_note_update.md): Editar nota de um registro (`crm:write`) - [`custom_objects.record_note_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_note_delete.md): Excluir nota de um registro (`crm:write`) - [`custom_objects.record_activities`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_activities.md): Histórico de um registro (`crm:read`) - [`custom_objects.links_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.links_list.md): Vínculos de um registro ou de um contato, oportunidade ou empresa (`crm:read`) - [`custom_objects.link_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.link_create.md): Vincular registros (`crm:write`) - [`custom_objects.link_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.link_delete.md): Desfazer um vínculo (`crm:write`) - [`custom_objects.links_opportunity_badges`](https://app.atomiks.com.br/docs/operacoes/custom_objects.links_opportunity_badges.md): Selos de objetos nos cards de oportunidade (`crm:read`) - [`custom_objects.views_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.views_list.md): Listar visões salvas de um objeto (`crm:read`) - [`custom_objects.view_create`](https://app.atomiks.com.br/docs/operacoes/custom_objects.view_create.md): Salvar visão de um objeto (`crm:write`) - [`custom_objects.view_update`](https://app.atomiks.com.br/docs/operacoes/custom_objects.view_update.md): Atualizar visão salva (`crm:write`) - [`custom_objects.view_delete`](https://app.atomiks.com.br/docs/operacoes/custom_objects.view_delete.md): Excluir visão salva (`crm:write`) - [`custom_objects.records_export`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_export.md): Exportar registros de um objeto em CSV (`crm:write`) - [`custom_objects.records_import_upload_url`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_import_upload_url.md): Pedir URL para enviar a planilha de importação (`crm:write`) - [`custom_objects.records_import`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_import.md): Importar registros de uma planilha (`crm:write`) - [`custom_objects.records_import_ai_mapping`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_import_ai_mapping.md): Sugerir o mapeamento das colunas da planilha com IA (`crm:read`) - [`custom_objects.records_import_ai_column`](https://app.atomiks.com.br/docs/operacoes/custom_objects.records_import_ai_column.md): Sugerir o campo de uma coluna da planilha com IA (`crm:read`) - [`custom_objects.record_job_get`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_job_get.md): Ver uma tarefa de registros (`crm:read`) - [`custom_objects.record_jobs_list`](https://app.atomiks.com.br/docs/operacoes/custom_objects.record_jobs_list.md): Listar tarefas de registros de um objeto (`crm:read`) - [`custom_objects.image_upload`](https://app.atomiks.com.br/docs/operacoes/custom_objects.image_upload.md): Enviar foto de um registro (`crm:write`)