Events API: Create, Update, and Publish Rescue Events

The Events API gives you programmatic access to your organization’s events — adoption days, fundraisers, clinics, training sessions, and team meetings. Events in RescueConsole connect to the animals attending, the shifts that staff them, and your public website. When you set an event to public, it appears on your rescue’s website immediately. Use this API to sync events from an external calendar, automate event creation as part of a larger workflow, or pull attendance and scheduling data into reports.

Setting isPublic to true on a new or existing event immediately publishes it to your rescue’s public website, including any animals listed in the animals array. To take an event off your site without cancelling it, update the record and set isPublic to false.

List Events

Retrieve a paginated list of events. Filter by status, type, date range, or public visibility.

GET /events

Query Parameters

integer

default:"1"

Page number to retrieve.

integer

default:"25"

Number of records per page. Maximum 100.

string

Filter by event status. One of draft, scheduled, completed, or cancelled.

string

Filter by event type. One of adoption-day, fundraiser, clinic, training, or meeting.

boolean

When true, returns only events published to your public website. When false, returns only non-public events.

string

Return events that start on or after this date and time. Format: ISO 8601 (e.g. 2026-10-01T00:00:00Z).

string

Return events that start on or before this date and time. Format: ISO 8601.

Example Request

curl -X GET "https://your-org.rescueconsole.com/api/v1/events?type=adoption-day&status=scheduled" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "evt_01hz1m3pqr9vde2kgf5bc7wy",
      "name": "October Adoption Day at PetSmart",
      "type": "adoption-day",
      "status": "scheduled",
      "startsAt": "2026-10-04T10:00:00Z",
      "endsAt": "2026-10-04T16:00:00Z",
      "locationId": "loc_01hw3r2mxpabcd1234ef",
      "isPublic": true,
      "description": "Join us for our monthly adoption day! Meet adoptable dogs and cats looking for their forever homes.",
      "animals": [
        "anim_01hx9z3kqp4f8vbn2tj7yd6m",
        "anim_01hx9z4lrp5g9wcn3uk8ze7n"
      ],
      "createdAt": "2026-09-15T09:00:00Z"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "perPage": 25,
    "totalPages": 1
  }
}

Retrieve an Event

Fetch the full record for a single event by ID.

GET /events/{id}

Path Parameters

string

required

The unique ID of the event record.

Example Request

curl -X GET "https://your-org.rescueconsole.com/api/v1/events/evt_01hz1m3pqr9vde2kgf5bc7wy" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Fields

string

The unique identifier for this event record.

string

The event name as it appears internally and, when published, on your public website.

string

The event type. One of adoption-day, fundraiser, clinic, training, or meeting.

string

The current event status. One of draft (not yet finalized), scheduled (confirmed and upcoming), completed (the event has passed), or cancelled (the event was called off).

string (ISO 8601)

The date and time the event starts, in UTC.

string (ISO 8601)

The date and time the event ends, in UTC. May be null if no end time has been set.

string

The ID of the location where the event takes place. May be null for virtual or off-site events with no location record.

boolean

Whether this event is currently published to your public website.

string

A description of the event. Shown on your public website when the event is published. May be null.

array of strings

IDs of animal records attending this event. These animals are featured on the public event listing when isPublic is true.

string (ISO 8601)

Timestamp when the event record was created.

Create an Event

Add a new event to your organization’s calendar.

POST /events

Request Body

string

required

The event name.

string

required

The event type. One of adoption-day, fundraiser, clinic, training, or meeting.

string

default:"draft"

The initial status. One of draft or scheduled. Defaults to draft.

string

required

Event start date and time in ISO 8601 format (e.g. 2026-10-04T10:00:00Z).

string

Event end date and time in ISO 8601 format. Recommended but not required.

string

The ID of the location where the event takes place.

boolean

default:"false"

Set to true to immediately publish this event to your public website on creation.

string

A description of the event. Shown publicly when isPublic is true.

array of strings

IDs of animal records to associate with this event. These animals appear on the public event listing.

Example Request

curl -X POST "https://your-org.rescueconsole.com/api/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "November Adoption Day",
    "type": "adoption-day",
    "status": "scheduled",
    "startsAt": "2026-11-01T10:00:00Z",
    "endsAt": "2026-11-01T15:00:00Z",
    "locationId": "loc_01hw3r2mxpabcd1234ef",
    "isPublic": false,
    "description": "Our monthly adoption event. Animals TBC.",
    "animals": []
  }'

Response

Returns 201 Created with the full event record as the response body.

Update an Event

Update one or more fields on an existing event. Only fields included in the request body are changed.

PATCH /events/{id}

Path Parameters

string

required

The unique ID of the event record to update.

Request Body

All fields are optional. Include only what you want to change.

string

Updated event name.

string

Updated event type. One of adoption-day, fundraiser, clinic, training, or meeting.

string

Updated event status. One of draft, scheduled, completed, or cancelled.

string

Updated start date and time in ISO 8601 format.

string

Updated end date and time in ISO 8601 format. Pass null to clear the end time.

string

Updated location ID. Pass null to remove the location association.

boolean

Set to true to publish this event to your public website; false to unpublish it.

string

Updated event description. Pass an empty string to clear it.

array of strings

Updated list of animal IDs attending this event. This replaces the entire animals array — include all animals you want associated after the update.

Example Request

curl -X PATCH "https://your-org.rescueconsole.com/api/v1/events/evt_01hz1m3pqr9vde2kgf5bc7wy" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "isPublic": true,
    "animals": [
      "anim_01hx9z3kqp4f8vbn2tj7yd6m",
      "anim_01hx9z4lrp5g9wcn3uk8ze7n",
      "anim_01hx9z5mrq6h0xdo4vl9af8p"
    ]
  }'

Response

Returns 200 OK with the full updated event record as the response body.

Event Types Reference

adoption-day

A public adoption event where attendees can meet and adopt animals. Link animals to this event type to feature them on your public website’s event listing.

fundraiser

A fundraising event such as a gala, auction, or benefit. Fundraiser events can appear on your public site to drive attendance and donations.

clinic

A veterinary or wellness clinic — for example, a low-cost vaccine day or a microchip clinic open to the public or restricted to your fosters.

training

A training session for volunteers or staff. Typically kept private (isPublic: false), but can be published if open to the public.

meeting

An internal team or board meeting. Generally kept private.

Overview

Resources

Events API: Create, Update, and Publish Rescue Events

List Events

Query Parameters

Example Request

Response

Retrieve an Event

Path Parameters

Example Request

Response Fields

Create an Event

Request Body

Example Request

Response

Update an Event

Path Parameters

Request Body

Example Request

Response

Event Types Reference

​List Events

​Query Parameters

​Example Request

​Response

​Retrieve an Event

​Path Parameters

​Example Request

​Response Fields

​Create an Event

​Request Body

​Example Request

​Response

​Update an Event

​Path Parameters

​Request Body

​Example Request

​Response

​Event Types Reference

List Events

Query Parameters

Example Request

Response

Retrieve an Event

Path Parameters

Example Request

Response Fields

Create an Event

Request Body

Example Request

Response

Update an Event

Path Parameters

Request Body

Example Request

Response

Event Types Reference