# Cal.com

Attify reads Cal.com through its API, read-only, with OAuth or an API token, for sales meetings and bookings. It is the customer's own system, so what Attify reads there is connected data: the strongest provenance, and what a vendor verification rests on.

## As a crm or calendar, for sales meetings and bookings

| Item             | Cal.com                                                                   |
|------------------|---------------------------------------------------------------------------|
| id               | booking `uid`                                                             |
| started_at       | `createdAt`                                                               |
| updated_at       | `updatedAt`, else `createdAt`                                             |
| start, end       | `start`, `end`                                                            |
| status           | accepted: booked; pending, awaiting_host: pending; cancelled, rejected:   |
|                  | cancelled (an unknown status reads as pending, never as booked)           |
| cancelled_at     | `updatedAt` of a cancelled booking (its last change, the cancellation)    |
| cancelled_by     | `cancelledByEmail`: a host's address is "host", an attendee's "invitee";  |
|                  | a rejected booking is the host's                                          |
| rescheduled_*    | `rescheduledFromUid` (or `fromReschedule`), `rescheduledToUid`            |
| created_by       | invitee, unless `metadata` carries an app marker (source, app, agent,     |
|                  | integration, created_by, booked_by): app, id that value (caller-set)      |
| changes          | the cancellation by `cancelledByEmail`, the reschedule by                 |
|                  | `rescheduledByEmail`: a host is "user", an attendee "invitee"             |
| ai               | null: Cal.com does not say                                                |
| attendance       | mark, no_show when every attendee is `absent`. `absentHost` (the host did |
|                  | not come) is not the customer's no-show and is not read                   |
| service          | `eventType.title`, else `eventType.slug`                                  |
| duration_minutes | `duration`, else end minus start                                          |
| price, currency  | null: not in the documented booking response (the event type holds them,  |
|                  | at today's price, not the booked one)                                     |
| provider,        | the first host's `email`                                                  |
| organizer        |                                                                           |
| attendees        | `attendees[]` (accepted) and `guests` (none)                              |
| location, title  | `location`, `title`                                                       |
| links            | `ical:<icsUid>`                                                           |
