> ## Documentation Index > Fetch the complete documentation index at: https://docs.airys.chat/llms.txt > Use this file to discover all available pages before exploring further. # Criar Contact > Criar um novo contato ## OpenAPI ````yaml /pt-br/swagger/tag_groups/application_swagger.json post /api/v1/accounts/{account_id}/contacts openapi: 3.1.0 info: title: Chatwoot description: Esta é a documentação da API para o servidor Chatwoot. version: 1.1.0 termsOfService: https://www.chatwoot.com/terms-of-service/ contact: email: hello@chatwoot.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://airys.chat/ security: [] tags: - name: AgentBots de Conta description: Agent Bots específicos da conta - name: Agentes description: APIs de gerenciamento de agentes - name: Respostas Prontas description: Respostas predefinidas para consultas comuns - name: Contatos description: APIs de gerenciamento de contatos - name: Rótulos de Contato description: Gerenciar rótulos de contato - name: Atribuições de Conversa description: Gerenciar atribuições de conversas - name: Rótulos de Conversa description: Gerenciar rótulos de conversas - name: Conversas description: APIs de gerenciamento de conversas - name: Atributos Personalizados description: Campos personalizados para contatos e conversas - name: Filtros Personalizados description: Filtros salvos para conversas - name: Caixas de Entrada description: Configuração de canais de comunicação - name: Integrações description: Integrações de terceiros - name: Rótulos description: APIs de gerenciamento de rótulos da conta - name: Mensagens description: APIs de gerenciamento de mensagens - name: Perfil description: APIs de perfil de usuário - name: Relatórios description: APIs de análise e relatórios - name: Equipes description: APIs de gerenciamento de equipe - name: Webhooks description: Webhooks de notificação de eventos - name: Regra de Automação description: Regras de automação de fluxo de trabalho - name: Central de Ajuda description: Gerenciamento da base de conhecimento paths: /api/v1/accounts/{account_id}/contacts: post: tags: - Contatos summary: Criar Contact description: Criar um novo contato operationId: contactCreate parameters: - $ref: '#/components/parameters/account_id' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/contact_create_payload' responses: '200': description: Sucesso content: application/json: schema: $ref: '#/components/schemas/extended_contact' '400': description: Erro de solicitação inválida (Bad Request) content: application/json: schema: $ref: '#/components/schemas/bad_request_error' security: - userApiKey: [] components: parameters: account_id: in: path name: account_id schema: type: integer required: true description: O ID numérico da conta schemas: contact_create_payload: type: object required: - inbox_id properties: inbox_id: type: number description: ID da caixa de entrada à qual o contato pertence example: 1 name: type: string description: nome do contato example: Alice email: type: string description: e-mail do contato example: alice@acme.inc blocked: type: boolean description: se o contato está bloqueado ou não example: false phone_number: type: string description: número de telefone do contato example: '+123456789' avatar: type: string format: binary description: >- Envie os dados do formulário com o binário da imagem do avatar ou use a avatar_url avatar_url: type: string description: O url para um arquivo jpeg, png para o avatar do contato example: https://example.com/avatar.png identifier: type: string description: Um identificador exclusivo para o contato no sistema externo example: '1234567890' additional_attributes: type: object description: >- Um objeto onde você pode armazenar atributos adicionais para o contato. exemplo {"type":"customer", "age":30} example: type: customer age: 30 custom_attributes: type: object description: >- Um objeto onde você pode armazenar atributos personalizados para o contato. exemplo {"type":"customer", "age":30}, isso deve ter uma definição de atributo personalizado válida. example: {} extended_contact: allOf: - $ref: '#/components/schemas/contact' - type: object properties: id: type: number description: Id do usuário availability_status: type: string enum: - online - offline description: Status de disponibilidade do usuário bad_request_error: title: data type: object properties: description: type: string errors: type: array items: $ref: '#/components/schemas/request_error' contact: type: object properties: payload: type: array items: type: object properties: additional_attributes: type: object description: O objeto contendo atributos adicionais relacionados ao contato availability_status: type: string description: O status de disponibilidade do contato email: type: string description: O endereço de e-mail do contato id: type: integer description: O ID do contato name: type: string description: O nome do contato phone_number: type: string description: O número de telefone do contato blocked: type: boolean description: Se o contato está bloqueado identifier: type: string description: O identificador do contato thumbnail: type: string description: A miniatura do contato custom_attributes: type: object description: Os atributos personalizados do contato example: attribute_key: attribute_value signed_up_at: dd/mm/yyyy last_activity_at: type: integer description: A última atividade em do contato created_at: type: integer description: A data de criação do contato contact_inboxes: type: array items: $ref: '#/components/schemas/contact_inboxes' request_error: type: object properties: field: type: string message: type: string code: type: string contact_inboxes: type: object properties: source_id: type: string description: ID da fonte da caixa de entrada do contato inbox: $ref: '#/components/schemas/inbox_contact' inbox_contact: type: object properties: id: type: number description: ID da caixa de entrada avatar_url: type: string description: A imagem de avatar da caixa de entrada channel_id: type: number description: O ID do canal name: type: string description: O nome da caixa de entrada channel_type: type: string description: O tipo da caixa de entrada provider: type: string description: O provedor da caixa de entrada securitySchemes: userApiKey: type: apiKey in: header name: api_access_token description: >- Este token pode ser obtido visitando a página de perfil ou por meio do console rails. Fornece acesso a endpoints com base nos níveis de permissões do usuário. Este token pode ser salvo por um sistema externo quando o usuário é criado via API, para realizar atividades em nome do usuário. ````