Attio

Доступ к Attio REST API с использованием управляемой OAuth-аутентификации. Позволяет работать с CRM-данными, включая объекты, записи, задачи, заметки, комментарии, списки, встречи и данные рабочего пространства.

Быстрый старт

Пример: получение списка всех объектов в рабочем пространстве.

# List all objects in workspace
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/attio/v2/objects')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/attio/{native-api-path}

Замените {native-api-path} на соответствующий путь эндпоинта Attio API. Шлюз проксирует запросы к api.attio.com и автоматически добавляет OAuth-токен.

Аутентификация

Все запросы требуют API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Войдите или зарегистрируйтесь на maton.ai
• Перейдите в настройки: maton.ai/settings
• Скопируйте свой API-ключ

Управление подключениями

Управляйте OAuth-подключениями Attio через сервис:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=attio&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'attio'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Получение информации о подключении

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Пример ответа:

{
 "connection": {
 "connection_id": "67b77f19-206e-494c-82c2-8668396fc1f1",
 "status": "ACTIVE",
 "creation_time": "2026-02-06T03:13:17.061608Z",
 "last_updated_time": "2026-02-06T03:13:17.061617Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "attio",
 "metadata": {}
 }
}

Откройте ссылку url в браузере, чтобы завершить OAuth-авторизацию.

Указание подключения

Если у вас несколько подключений Attio, можно явно указать нужное через заголовок:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/attio/v2/objects')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '67b77f19-206e-494c-82c2-8668396fc1f1')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF