botpress--botpress/integrations/attio/hub.md

Botpress Integration: Attio CRM

Overview

The Attio integration connects your Botpress bot to Attio’s workspace data so you can list, retrieve, create, and update records across your objects directly from their chatbot.

Configuration

To protect your workspace, this integration uses an API token you provide. Create a token in Attio and paste it in your integration configuration.

Steps

1. In Attio, create an API token with the following scopes:
   • object_configuration:read - Required to list and retrieve object definitions
   • record:read - Required to list and retrieve records
   • record:write - Required to create and update records
2. In Botpress, add the Attio integration to your bot.
3. Paste your API token in the integration configuration and save.

That's it — the integration will validate access using Attio's /v2/self endpoint.

Notes

• Filtering syntax for List Records follows Attio’s filtering guide. Pass your filter object as provided by Attio —
• For create/update, provide values using attribute slugs or IDs accepted by Attio.