Attrove Workflows Connect Goals Docs Pricing

Attrove API Reference

REST API for communication intelligence: provision users, connect Gmail, Outlook, Slack, Google Calendar, Google Meet, and Microsoft Teams, then query, search, and watch outcomes with cited evidence. Base URL: https://api.attrove.com/v1. Partner endpoints authenticate with client_id + client_secret; user endpoints authenticate with the per-user sk_ token.

Full request/response examples for every endpoint: llms-full.txt. SDK: TypeScript SDK. AI clients: MCP integration.

User Management API

Server-to-server endpoints for creating users and starting the OAuth connect flow. Requires your client_id and client_secret. To land users back on a specific page of your product after OAuth, configure a redirect_url on your API key in the dashboard (connect.attrove.com → API Keys → edit). See OAuth Completion Redirect below.

  • POST /v1/users — Create a user
  • POST /v1/users/:user_id/connect-sessions — Create a durable connect session
  • GET /integrations/connect?session=:session_id — Open the activation URL
  • POST /v1/users/:user_id/integrations/connect — OAuth Completion Redirect
  • GET /v1/users/settings — Get organization sync settings
  • PATCH /v1/users/settings — Update organization sync settings

Webhooks API

Configure outbound webhook endpoints, send test events, rotate secrets, and inspect delivery attempts.

  • POST /v1/webhooks — Create a webhook endpoint
  • GET /v1/webhooks — List webhook endpoints
  • GET /v1/webhooks/:id — Get webhook endpoint
  • PATCH /v1/webhooks/:id — Update endpoint configuration
  • POST /v1/webhooks/:id/test — Send a test webhook
  • POST /v1/webhooks/:id/rotate-secret — Rotate webhook secret
  • DELETE /v1/webhooks/:id — Delete webhook endpoint
  • GET /v1/webhooks/:id/deliveries — List delivery attempts

User Data API

Call these endpoints with an end-user sk_ token. Where relevant, examples use a full-year date range.

  • GET /v1/users/:user_id — Retrieve user profile
  • GET /v1/users/:user_id/sync-stats — Get sync statistics
  • GET /v1/users/:user_id/conversations — List conversations
  • PATCH /v1/users/:user_id/conversations — Update conversation sync settings
  • POST /v1/users/:user_id/search — Semantic search
  • POST /v1/users/:user_id/query — AI query
  • GET /v1/users/:user_id/integrations/:id — Get integration by ID
  • DELETE /v1/users/:user_id/integrations/:integration_id — Disconnect an integration
  • GET /v1/users/:user_id/messages — List and filter messages
  • GET /v1/users/:user_id/messages/:id — Fetch single message
  • GET /v1/users/:user_id/entities — List contacts
  • GET /v1/users/:user_id/entities/:id — Retrieve a contact
  • GET /v1/users/:user_id/entities/relationships — Get relationship graph

Goals API

Watched outcomes. A goal names an outcome (a renewal, a deal, a commitment), and Attrove keeps re-evaluating it against the communication stream: lifecycle and health update with cited evidence, risk signals, and suggested next actions. Lifecycle never changes autonomously; humans confirm transitions with a reason.

  • POST /v1/users/:user_id/goals — Create a goal
  • GET /v1/users/:user_id/goals — List goals
  • GET /v1/users/:user_id/goal-events — List goal events
  • GET /v1/users/:user_id/goals/:goal_id — Get a goal
  • PATCH /v1/users/:user_id/goals/:goal_id — Update a goal
  • POST /v1/users/:user_id/goals/:goal_id/evaluate — Queue an evaluation
  • POST /v1/users/:user_id/goals/:goal_id/status — Confirm or override status
  • GET /v1/users/:user_id/goals/:goal_id/evidence — Get goal evidence
  • GET /v1/users/:user_id/goals/:goal_id/snapshots — List goal snapshots
  • POST /v1/users/:user_id/goals/:goal_id/archive — Archive a goal
  • POST /v1/users/:user_id/goals/:goal_id/cancel — Cancel a goal

Calendar & Events API

Access user calendars and events from connected calendar integrations. Use an end-user sk_ token for authentication.

  • GET /v1/users/:user_id/calendars — List user calendars
  • GET /v1/users/:user_id/calendars/:id — Get calendar by ID
  • PATCH /v1/users/:user_id/calendars/:id — Update calendar active status
  • GET /v1/users/:user_id/events — List events
  • GET /v1/users/:user_id/events/:id — Get event by ID

Meetings API

Access meeting recordings and AI-generated summaries from connected meeting sources. Supports Google Meet, Zoom, and Teams provider filters. Includes transcripts, action items, and attendee information.

  • GET /v1/users/:user_id/meetings — List user meetings
  • GET /v1/users/:user_id/meetings/:id — Get meeting by ID
  • PATCH /v1/users/:user_id/meetings/:id — Update meeting
  • POST /v1/users/:user_id/meetings/:id/regenerate-summary — Regenerate AI summary

Threads API

Discover and analyze conversation threads with AI-powered semantic search and structured insights extraction.

  • POST /v1/users/:user_id/threads/discover — Discover threads
  • POST /v1/users/:user_id/threads/:conversation_id/analyze — Analyze thread
  • GET /v1/users/:user_id/threads/:thread_id/messages — List thread messages

Push API

Push data directly into Attrove without requiring OAuth connections. Auto-provisions virtual integrations for each data type. Data is queued for async processing and becomes searchable via /search and AI queries once indexed.

  • POST /v1/users/:user_id/messages — Push message
  • POST /v1/users/:user_id/meetings — Push meeting
  • POST /v1/users/:user_id/events — Push event
  • POST /v1/users/:user_id/notes — Push note

Notes API

Read notes created via push endpoints or partner systems. Notes can be linked to messages, meetings, events, entities, or goals via cross-references.

  • GET /v1/users/:user_id/notes — List notes
  • GET /v1/users/:user_id/notes/:note_id — Get note by ID