# Accoil API

**Canonical:** https://apis.io/apis/accoil/accoil-api/  
**Provider:** Accoil — https://apis.io/providers/accoil/  
**Base URL:** https://in.accoil.com  
**Documentation:** https://developer.accoil.com/docs/accoil-api

Accoil API is one of 2 APIs that [Accoil](https://apis.io/providers/accoil/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Accoil API as documented publicly: 17 operations. Contract generated from the documentation by API Evangelist (2026-10-26); not the provider's own document.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/` | POST / |
| GET | `/v1/accounts` | Legacy lookup of accounts (still supported) |
| POST | `/v1/events` | POST /v1/events |
| POST | `/v1/groups` | POST /v1/groups |
| POST | `/v1/users` | Identify a user (legacy) |
| GET | `/v2/accounts` | List accounts in a workspace, ranked by engagement score |
| GET | `/v2/accounts/{id}` | Retrieve a single account with its full metric set |
| POST | `/v2/group` | Associate a user with an account and set account traits |
| POST | `/v2/identify` | Identify a user and set their traits |
| GET | `/v2/segments` | List segments in a workspace |
| GET | `/v2/segments/{id}` | Retrieve a single segment |
| GET | `/v2/segments/{id}/members` | List the members of a segment |
| POST | `/v2/track` | Record a user event |
| GET | `/v2/users` | List users in a workspace, or look one up by email or tracking ID |
| GET | `/v2/users/{id}` | Retrieve a single user with its full metric set |
| GET | `/v2/workspaces` | List the workspaces your token can access |
| GET | `/v2/workspaces/{id}` | Retrieve a single workspace |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/accoil/openapi/_ae-authored/accoil-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v2-workspaces-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v1-accounts-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v2-accounts-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v2-segments-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v2-segments-id-members-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accoil/json-schema/accoil-get-v2-users-response-schema.json

## Other Accoil APIs (1)

- [Accoil API](https://apis.io/apis/accoil/accoil-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/accoil/accoil-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/accoil/.