# Calendly

Attify reads Calendly 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             | Calendly                                                                  |
|------------------|---------------------------------------------------------------------------|
| id               | the invitee `uri`                                                         |
| started_at       | invitee `created_at`                                                      |
| updated_at       | the latest of the invitee's and the event's `updated_at`, the no-show's   |
|                  | and the cancellation's `created_at` (a mark may not move `updated_at`)    |
| start, end       | event `start_time`, `end_time`                                            |
| status           | cancelled: the invitee or the event is canceled; booked otherwise         |
| cancelled_at     | `cancellation.created_at` (the invitee's, else the event's)               |
| cancelled_by     | `cancellation.canceler_type`: invitee is "invitee", host is "host"        |
| rescheduled_*    | `old_invitee` / `new_invitee` (invitee uris, so item ids)                 |
| created_by       | app: `scheduling_method` api; user: `invitee_scheduled_by` (that user's   |
|                  | uri); invitee otherwise, id the event type (the booking link used)        |
| changes          | the cancellation, by "invitee" or "user" (host), fields start when it was |
|                  | a reschedule (`rescheduled`), else status                                 |
| ai               | null: Calendly does not say                                               |
| attendance       | mark, no_show when `no_show` is set; by_app false (who marked it is not   |
|                  | recorded)                                                                 |
| service, title   | event `name` (the event type's name)                                      |
| duration_minutes | end minus start                                                           |
| price, currency  | invitee `payment.amount`, `payment.currency`                              |
| provider,        | the first event membership's `user_email` (the host)                      |
| organizer        |                                                                           |
| attendees        | the invitee, accepted                                                     |
| location         | event `location.location`, else its `type`                                |
| links            | `calendly:<event uri>`; `google:<id>` when the event's `calendar_event`   |
|                  | is a Google one (unverified field)                                        |
