# Migramos os IDs para Object IDs

> Passamos a usar Object IDs em todas as entidades, para mais legibilidade e escalabilidade.

2026-01-27 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Passamos a usar **Object IDs** em todas as entidades. A mudança melhora a legibilidade, permite gerar IDs de forma independente em cada serviço e garante que eles sejam únicos em escala.

## O que são Object IDs?

Object IDs são identificadores únicos com um prefixo que indica o tipo de entidade. Em vez de um ID genérico como `12345` ou um UUID, você recebe algo assim:

```
em_48klx31D1jqAfDcG53R8y1j1XbP
```

O prefixo `em_` mostra na hora que se trata de uma entidade de e-mail.

## Vantagens

- **Legíveis**: você reconhece o tipo de entidade de relance
- **Únicos**: sem colisões entre serviços
- **Ordenados**: os IDs podem ser ordenados pela data de criação
- **Escaláveis**: gerados de forma independente, sem coordenação com o banco de dados

## Prefixos das entidades

- **Listas de contatos (audiences)**: `aud_`
- **Campanhas**: `cmp_`
- **Cliques**: `click_`
- **Contatos**: `con_`
- **Credenciais**: `key_`
- **Campos personalizados**: `cf_`
- **Entregas**: `del_`
- **E-mails**: `em_`
- **Eventos**: `evt_`
- **Arquivos**: `file_`
- **Links**: `link_`
- **Carregamentos**: `load_`
- **E-mails na fila**: `que_`
- **Domínios**: `dom_`
- **Inscritos**: `sub_`
- **Supressões**: `sup_`
- **Descadastros**: `uns_`
- **Requisições de webhook**: `whr_`
- **Webhooks**: `wh_`

## Migração concluída

Migramos mais de 1,5 bilhão de registros para o novo formato de Object ID. Todas as respostas da API v2 agora retornam Object IDs para as entidades listadas acima.

---

Source: https://emailit.com/pt/blog/migrando-ids-para-object-ids/
