> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadstaker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros passos

> Da chave de API ao primeiro contato criado, em cinco minutos.

Este guia leva você de zero a um contato criado pela API, com o registro visível no dashboard.

## Antes de começar

Você precisa de um projeto no Leadstaker e de acesso de membro a ele. Se ainda não tem, [crie sua conta](https://app.leadstaker.com).

## 1. Gere uma chave de API

No dashboard, acesse as **configurações do projeto** e clique em **gerar token**.

Guarde a chave assim que ela aparecer: ela não é mostrada de novo. Detalhes em [Autenticação](/api-reference/authentication).

## 2. Confirme que a chave funciona

```bash theme={null}
curl https://n-api.leadstaker.com/v1/contacts \
  -H "x-api-key: SUA_CHAVE"
```

Uma resposta `200` com um envelope `{ "data": [...] }` significa que a chave está válida e já escopada no seu projeto. Um `401` significa chave errada ou vencida.

## 3. Descubra os campos do projeto

Um contato no Leadstaker não tem colunas fixas: nome, telefone e o resto são **campos** configuráveis por projeto. Antes de criar alguém, veja quais existem:

```bash theme={null}
curl "https://n-api.leadstaker.com/v1/fields?entityTypes=CONTACT" \
  -H "x-api-key: SUA_CHAVE"
```

Anote o `id` dos campos que você vai preencher.

## 4. Crie um contato

```bash theme={null}
curl -X POST https://n-api.leadstaker.com/v1/contacts \
  -H "x-api-key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      { "fieldId": "ID_DO_CAMPO_NOME", "value": "Maria Andrade" },
      { "fieldId": "ID_DO_CAMPO_TELEFONE", "value": "+5551999999999" }
    ]
  }'
```

<Note>
  Esse endpoint faz upsert. Se já existir um contato equivalente, a resposta é `200` com o registro existente em vez de `201` com um novo. Use o status para saber o que aconteceu.
</Note>

## 5. Encontre o contato de volta

```bash theme={null}
curl -G https://n-api.leadstaker.com/v1/contacts \
  -H "x-api-key: SUA_CHAVE" \
  --data-urlencode "search=Maria" \
  --data-urlencode "[limit]=10"
```

A gramática completa de filtros, ordenação e paginação está em [Filtros, ordenação e paginação](/api-reference/listing).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/api-reference/authentication">
    Escopo da chave e expiração.
  </Card>

  <Card title="Erros" icon="triangle-exclamation" href="/api-reference/errors">
    O formato de erro e o que cada código quer dizer.
  </Card>
</CardGroup>