# Book meetings from your own app or an AI assistant

> SkedX CRM’s Calendar can be used by other software. From your own app or a partner tool: the partner API at https://crmserver.skode.ai/api/partner/v1/calendar/ — people/ (who you may book for), slots/?person=&from=&to=&duration= (free times: the person’s working hours minus their meetings, lunch and time off, an hour’s notice), bookings/ (GET lists meetings in a window you may see; POST books {person, start, duration, title, email, phone, notes}) and bookings/<id>/cancel/. Every answer carries the header Skode-Version: 2026-10-20; send it to pin the version. Sign in with the partner OAuth connection, or with a Calendar key made in Settings › Integrations › Developer (scopes calendar:read, calendar:write; the key acts as the person who made it, in the key’s company). From an AI assistant: the SkedX connector for Claude and ChatGPT has one calendar tool with actions find_slots, book and bookings; book shows a preview first and books only after you agree. Rules on both doors: only people your role lets you open in Calendar; the time is checked again at the moment of booking (taken → just_taken with the next free times); email or phone only link the meeting to an existing record, never create one; sending the same Idempotency-Key (or ref) twice gives the first booking back; a colleague’s synced meeting shows only as Busy; each booking is counted as calendar.booking and passes your wallet check — free on the basic plan. A meeting a visitor booked through your booking link, or one from Outlook or Google, is not cancelled from here.

Product: SkedX CRM · Topic: Calendar · Draft — steps not yet re-verified in the live product

Your website, a partner tool or an AI assistant books into the same calendar your team uses — never a time that is taken, never a stranger’s record.

## Step 1: Find the Calendar card

Open **Settings › Integrations**, then **Developer**. The Calendar card shows the address for your own app, the AI connector’s Calendar tool, how many bookings came in this month, and your Calendar keys. **Create a Calendar key** makes one.
Open it directly: https://crm.skode.ai/settings/integrations?tab=developer

## Step 2: Make a key for your app

Name the key after where it will live and choose what it can do: **Read and book**, or **Read only**. It acts as you — it books you and the people you may open in Calendar. Copy it straight away: it is shown once.

## Step 3: Ask for free times, then book one

Send `GET …/calendar/slots/?from=…&to=…&duration=30` with `Authorization: Bearer <key>`, then `POST …/calendar/bookings/` with one of the times as `start` and an `Idempotency-Key`. A time taken a moment ago answers `409 just_taken` with the next free times.

## Step 4: Or ask your AI assistant

With the SkedX connector in Claude or ChatGPT, ask “When is Meera free on Thursday? Book the first slot for Anita.” The assistant shows the booking it is about to make and books only after you say yes.

## Common questions

### Can it create a new person?

No. An email or phone only links the meeting to a record that already exists — a person is added to the CRM only by your own rules.

### What does a booking cost?

Nothing on the basic plan. Each one is still counted as a calendar booking and passes your wallet check, so a price can never arrive as a surprise.

### Can a key see a colleague’s private meetings?

No. A colleague’s meeting from Outlook or Google comes back as Busy with its times — exactly what Calendar shows you.

### Why was my cancel refused?

A meeting a visitor booked through your link is cancelled from Calendar, so they are told; a meeting from Outlook or Google is changed in that calendar.

Videos and screenshots © 2026 SkedX, with sample data only. Share and link to them freely; copying the SkedX product or its design is not allowed. Terms: https://skode.ai/terms/

## Related guides
- Your calendar: the week, a meeting at a glance, and moving it: https://skode.ai/help/crm/calendar/your-calendar/
- Create a booking link and share it: https://skode.ai/help/crm/calendar/create-a-booking-link/

Source: https://skode.ai/help/crm/calendar/book-meetings-from-your-app-or-an-ai-assistant/