Notion API | N8N Academy

🎯

Visão Geral

Notion combina notas, databases, wikis e projetos em um só lugar. A API permite manipular páginas e databases programaticamente.

📄

Páginas

Criar e editar conteúdo

🗃️

Databases

CRUD em databases

🔍

Buscar

Filtrar e ordenar

🧱

Blocks

Adicionar conteúdo

Criar Integration

1.1 Acessar Developer Portal

1. Acesse notion.so/my-integrations
2. Clique em "+ New integration"

1.2 Configurar a Integration

Name:

N8N Automation

Associated workspace:

Seu workspace

Capabilities (marque todas que precisar):

// Capacidades disponíveis:
✅ Read content           // Ler páginas e databases
✅ Update content         // Atualizar conteúdo
✅ Insert content         // Criar novos itens
✅ Read comments          // Ler comentários
✅ Create comments        // Criar comentários
✅ Read user information  // Info de usuários (opcional)
          

✅ Integration Criada!

Copie o Internal Integration Token:

secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Conectar Páginas/Databases

⚠️ Passo CRÍTICO!

A integration NÃO tem acesso automático às suas páginas. Você precisa conectar manualmente cada página/database que quer acessar.

Como Conectar:

1. Abra a página ou database no Notion
2. Clique nos 3 pontos (...) no canto superior direito
3. Role até "Connections" ou "Add connections"
4. Busque e selecione "N8N Automation" (sua integration)
5. Confirme a conexão

Obter Page/Database ID

// URL de uma página:
https://www.notion.so/Minha-Pagina-abc123def456...
                                    ↑
                                    Page ID (32 chars, sem hífens)

// URL de um database:
https://www.notion.so/abc123def456?v=xyz
                       ↑
                       Database ID

// Formato do ID (com hífens):
abc123de-f456-7890-abcd-ef1234567890
          

Configurar no N8N

3.1 Criar Credencial

1. No N8N, vá em Credenciais → Adicionar
2. Pesquise: "Notion API"
3. Cole o Internal Integration Token
4. Clique em Salvar

📋

Exemplos Práticos

🗃️ Buscar no Database

// Node: Notion
// Operation: Get Many (Database)

Database: Tarefas

Filter:
{
  "property": "Status",
  "select": {
    "equals": "Em Progresso"
  }
}

Sort:
{
  "property": "Due Date",
  "direction": "ascending"
}
          

➕ Criar Item no Database

// Node: Notion
// Operation: Create (Database Page)

Database: Clientes

Properties:
  Name (title): {{ $json.nome }}
  Email (email): {{ $json.email }}
  Status (select): Novo
  Created (date): {{ $now }}
          

✏️ Atualizar Item

// Node: Notion
// Operation: Update (Database Page)

Page ID: {{ $json.notion_id }}

Properties:
  Status (select): Convertido
  Notes (rich_text): Cliente fechou!
  Value (number): {{ $json.valor }}
          

🧱 Adicionar Conteúdo à Página

// Node: Notion
// Operation: Append After (Block)

Page ID: abc123...

Blocks:
[
  {
    "type": "heading_2",
    "heading_2": {
      "rich_text": [
        { "text": { "content": "Resumo" } }
      ]
    }
  },
  {
    "type": "paragraph",
    "paragraph": {
      "rich_text": [
        { "text": { "content": "Texto aqui..." } }
      ]
    }
  }
]
          

📄 Ler Conteúdo de Página

// Node: Notion
// Operation: Get (Page)

Page ID: abc123...

// Retorna:
{
  "id": "abc123...",
  "properties": {
    "Name": {...},
    "Status": {...}
  }
}

// Para ler blocks (conteúdo):
// Operation: Get All (Block)
// Block ID: (mesmo ID da página)
          

🔍 Busca Global

// Node: Notion
// Operation: Search

Query: termo de busca

Filter:
{
  "property": "object",
  "value": "page"  // ou "database"
}

// Busca em todas as páginas
// conectadas à integration
          

🏷️

Tipos de Propriedade

Formato de cada tipo

// Title (obrigatório em todo database):
"Name": {
  "title": [{ "text": { "content": "Texto" } }]
}

// Rich Text:
"Description": {
  "rich_text": [{ "text": { "content": "Texto" } }]
}

// Number:
"Price": { "number": 99.99 }

// Select:
"Status": { "select": { "name": "Ativo" } }

// Multi-select:
"Tags": { "multi_select": [{ "name": "Tag1" }, { "name": "Tag2" }] }

// Date:
"Due Date": { "date": { "start": "2024-12-31" } }

// Checkbox:
"Done": { "checkbox": true }

// URL:
"Link": { "url": "https://exemplo.com" }

// Email:
"Contact": { "email": "email@exemplo.com" }

// Phone:
"Phone": { "phone_number": "+55 11 99999-9999" }

// People:
"Assignee": { "people": [{ "id": "user_id" }] }

// Relation:
"Project": { "relation": [{ "id": "page_id" }] }
        

🔧

Troubleshooting

❌ "Could not find page/database"

Causa: Integration não está conectada à página.

Solução: Conecte a integration à página via menu (...) → Add connections.

❌ "Invalid property format"

Causa: Formato errado para o tipo de propriedade.

Solução: Cada tipo tem formato específico. Consulte a documentação de tipos acima.

❌ "API token is invalid"

Causa: Token incorreto ou integration deletada.

Solução: Verifique o token em notion.so/my-integrations.

Notion Configurado!

Agora você pode automatizar seu workspace Notion.

Próximo: Outros LLMs → Ver Todas as Conexões