---
title: "Overview"
description: "What the Partners API does and how to make your first request."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.withoutaworry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

The Partners API lets an approved partner create and update bookings and contacts in a WaW customer's account. Your system sends the data, and it appears in the customer's WaW team right away.

The API is write-only. It has four routes:

| Method | Path | What it does |
| --- | --- | --- |
| POST | `/v1/bookings` | [Create a booking](/partners-api/bookings#create-a-booking) |
| PATCH | `/v1/bookings/{id}` | [Update a booking](/partners-api/bookings#update-a-booking) |
| POST | `/v1/contacts` | [Create a contact](/partners-api/contacts#create-a-contact) |
| PATCH | `/v1/contacts/{id}` | [Update a contact](/partners-api/contacts#update-a-contact) |

## Base URLs

| Environment | Base URL |
| --- | --- |
| Production | `https://api.withoutaworry.com` |
| Acceptance | `https://acc-api.withoutaworry.com` |

Add the route path to the base URL, for example `https://api.withoutaworry.com/v1/bookings`.

## Before you start

You need a customer key for each WaW customer you work with. WaW issues the key after the customer approves the connection. Contact WaW to set one up. See [Authentication](/partners-api/authentication) for how to use it.

Building a connection for many customers? Start with [Integrate WaW into your platform](/partners-api/integrate).

## Your first request

Create a contact, then create a booking for that contact.

```sh
curl https://api.withoutaworry.com/v1/contacts \
  -H "Authorization: Bearer $WAW_CUSTOMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
"external_id": "person-8421",
"first_name": "Noor",
"last_name": "Janssens",
"email": "noor@example.com"
  }'
```

The response holds the WaW ID of the new contact:

```json
{ "id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f", "external_id": "person-8421" }
```

Pass that ID as `contact_id` when you create the booking:

```sh
curl https://api.withoutaworry.com/v1/bookings \
  -H "Authorization: Bearer $WAW_CUSTOMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
"external_id": "booking-8421",
"name": "Wedding Noor and Sam",
"start_date": "2027-06-12T16:00:00+02:00",
"end_date": "2027-06-13T02:00:00+02:00",
"location": "Ghent",
"contact_id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f",
"status": "confirmed"
  }'
```

Store both WaW IDs on your side. You need them to update the records later.

## Interactive reference

The full OpenAPI description is available as an [interactive reference](https://www.withoutaworry.com/partners-api/) and as [raw JSON](https://www.withoutaworry.com/partners-api/openapi.json).

Source: https://docs.withoutaworry.com/partners-api/overview/index.mdx
