Closed Beta. Request early access to be one of the first to try Weddinguru!
Documentation

Developer
Docs

Comprehensive guides and API reference for Weddinguru

Getting Started
API Reference
Webhooks
SDKs

Introduction

Welcome to the Weddinguru API documentation. Our API allows you to integrate Weddinguru with your existing systems, build custom workflows, and automate your wedding planning processes.

The Weddinguru API is organised around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL

https://api.weddinguru.co.uk/v1

Authentication

The Weddinguru API uses API keys to authenticate requests. You can view and manage your API keys in your organisation settings.

Authentication is performed via HTTP Bearer token. Provide your API key as the bearer token value: 

Authorization: Bearer your_api_key_here

Quick Start

Here's a simple example to get you started:

curl https://api.weddinguru.co.uk/v1/weddings \
  -H "Authorization: Bearer your_api_key_here"

Weddings API

List all weddings

GET /v1/weddings

Returns a list of all weddings in your organisation.

Create a wedding

POST /v1/weddings

Creates a new wedding with the provided details.

Get a wedding

GET /v1/weddings/:id

Retrieves a specific wedding by ID.

Update a wedding

PUT /v1/weddings/:id

Updates an existing wedding.

Delete a wedding

DELETE /v1/weddings/:id

Deletes a wedding and all associated data.

Couples API

Manage couple information associated with weddings.

GET /v1/couples
POST /v1/couples

Guests API

Manage guest lists for weddings.

GET /v1/weddings/:wedding_id/guests
POST /v1/weddings/:wedding_id/guests

Invoices API

Create and manage invoices for your weddings.

GET /v1/invoices
POST /v1/invoices

Webhook Setup

Webhooks allow you to receive real-time notifications when events happen in your Weddinguru account. Configure webhook endpoints in your organisation settings.

Webhook Events

Available webhook events:

  • wedding.created - A new wedding was created
  • wedding.updated - A wedding was updated
  • guest.rsvp - A guest responded to an RSVP
  • invoice.paid - An invoice was paid

Python SDK

pip install weddinguru

from weddinguru import Client

client = Client(api_key='your_api_key')
weddings = client.weddings.list()

JavaScript SDK

npm install weddinguru

const Weddinguru = require('weddinguru');

const client = new Weddinguru({ apiKey: 'your_api_key' });
const weddings = await client.weddings.list();