# AddCal API Documentation

The official AddCal API documentation. This comprehensive guide provides developers with everything needed to integrate calendar and event management functionality into their applications. Our RESTful API enables seamless creation, management, and sharing of events across multiple platforms and calendar services.

- Base URL: `https://addcal.co`
- Authentication: HTTP Bearer token. You can retrieve your token from the [API Tokens page](https://addcal.co/user/api-tokens) in your dashboard.
- OpenAPI document: https://addcal.co/docs.openapi
- Interactive reference: https://addcal.co/docs

Send the token on every request:

```
Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
```

## Sections

- [Create Event](https://addcal.co/docs/create-event.md)
- [Calendars](https://addcal.co/docs/calendars.md)
- [Events](https://addcal.co/docs/events.md)
- [Events > RSVPs](https://addcal.co/docs/rsvps.md)
- [Events > Invites](https://addcal.co/docs/invites.md)
- [Account](https://addcal.co/docs/account.md)
- [Dynamic Links](https://addcal.co/docs/dynamic-links.md)

## Account

APIs for managing the authenticated user's account

### Get Current User

`GET /api/users/me`

**Example request**

```bash
curl --request GET \
  --url 'https://addcal.co/api/users/me' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Accept: application/json'
```

**Response 200**

```json
{
    "user": {
        "uid": "ta8ck2mzgfdv",
        "name": "Test User",
        "email": "test@example.com",
        "created_at": "2025-07-27T06:39:24.000000Z",
        "updated_at": "2026-08-08T01:05:54.000000Z"
    },
    "teams": [
        {
            "uid": "v08acy4z0l57",
            "name": "Email Limit Test (1990 used)",
            "personal_team": false,
            "is_owner": true,
            "is_subscribed": true,
            "timezone": null,
            "created_at": "2026-07-19T04:28:25.000000Z",
            "updated_at": "2026-07-19T04:28:25.000000Z"
        },
        {
            "uid": "vvmknusj2w7g",
            "name": "Email Limit Test (990 used)",
            "personal_team": false,
            "is_owner": true,
            "is_subscribed": true,
            "timezone": null,
            "created_at": "2026-07-19T04:28:25.000000Z",
            "updated_at": "2026-07-19T05:31:52.000000Z"
        },
        {
            "uid": "b9jftdrz6ad2",
            "name": "Test User's Team",
            "personal_team": true,
            "is_owner": true,
            "is_subscribed": true,
            "timezone": null,
            "created_at": "2025-07-27T06:39:24.000000Z",
            "updated_at": "2026-07-05T05:17:19.000000Z"
        }
    ],
    "current_team": {
        "uid": "b9jftdrz6ad2",
        "name": "Test User's Team",
        "personal_team": true,
        "is_owner": true,
        "is_subscribed": true,
        "timezone": null,
        "created_at": "2025-07-27T06:39:24.000000Z",
        "updated_at": "2026-07-05T05:17:19.000000Z"
    }
}
```