---
title: "Create an event rsvp"
method: POST
path: "/api/v2/event_rsvps"
tags: ["Event Rsvps"]
---

# Create an event rsvp

`POST /api/v2/event_rsvps`

## Request

- Base URL: `https://yournation.nationbuilder.com`
- URL: `https://yournation.nationbuilder.com/api/v2/event_rsvps`
- Auth: HTTP bearer

Creates an event RSVP. Event RSVPs must contain enough signup data to find an existing signup in the nation, or create a new one. This means callers must provide a first name, last name, and email as part of the Event RSVP payload, which will be matched to an existing signup or will create a new signup with that data. Alternatively, callers may sidepost a signup resource as part of the payload. See sideposting documentation for details.

## Request body

- EventRsvpCreateRequest: The JSON:API top-level document shape for create requests, whose data member carries the new resource's type and attributes.
  - `data` object, required
    - `type` 'event_rsvps', required: The JSON:API resource type of the resource being created.
    - `attributes` object: The write-only attributes of a event_rsvp.
      - `amount_in_cents` integer, nullable: The cost of the RSVP in cents.
      - `attendee` boolean, nullable: The signup is attending the event.
      - `canceled` boolean, nullable: The RSVP was canceled.
      - `email` string, nullable: The email address of the attendee.
      - `event_id` string, nullable: The associated event.
      - `first_name` string, nullable: The attendee's first name.
      - `guests_count` integer, nullable: Number of guests on the RSVP.
      - `last_name` string, nullable: The attendee's last name.
      - `page_id` string, nullable: The associated page.
      - `prepaid` boolean, nullable: The RSVP has already been paid.
      - `private` boolean, nullable: The RSVP is private.
      - `tickets_count` integer, nullable: Number of tickets sold with this RSVP.
      - `volunteer` boolean, nullable: The attendee is a volunteer.
      - `billing_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's Billing address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.
      - `home_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's Home address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.
      - `mailing_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's Mailing address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.
      - `phone_number` string, nullable: The attendee's phone number
      - `registered_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's Registered address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.
      - `user_submitted_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's User submitted address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.
      - `work_address_attributes` object, nullable: Attribute used to write data to the given event_rsvp's Work address. When an address already exists, provided values will be used to patch the existing address data, only overwriting values provided in the payload. When no address exists, the existing data will be used to persist a new address.

## Response `201`

The newly created event rsvp.

- EventRsvpShowResponse: The JSON:API top-level document shape for responses returning a single resource under the data member.
  - `data` object, required: A JSON:API resource identifier object, the type/id pair that uniquely identifies a single resource.
    - `id` string, required: Unique identifier of the resource.
    - `type` 'event_rsvps', required: The JSON:API resource type.
    - `attributes` object: The read-only attributes of a event_rsvp.
      - `amount_in_cents` integer, nullable: The cost of the RSVP in cents.
      - `attendee` boolean, nullable: The signup is attending the event.
      - `canceled` boolean, nullable: The RSVP was canceled.
      - `email` string, nullable: The email address of the attendee.
      - `event_id` string, nullable: The associated event.
      - `first_name` string, nullable: The attendee's first name.
      - `guests_count` integer, nullable: Number of guests on the RSVP.
      - `last_name` string, nullable: The attendee's last name.
      - `page_id` string, nullable: The associated page.
      - `prepaid` boolean, nullable: The RSVP has already been paid.
      - `private` boolean, nullable: The RSVP is private.
      - `tickets_count` integer, nullable: Number of tickets sold with this RSVP.
      - `volunteer` boolean, nullable: The attendee is a volunteer.
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
  - `included` Resource[]: Sideloaded resources requested via the include query parameter. Each entry is a full resource object whose shape is documented under its own resource type.
    - `id` string, required: Unique identifier of the resource.
    - `type` string, required: The JSON:API resource type.
    - `attributes` object: The attributes of the resource, as documented for its resource type.
    - `relationships` object: References from this resource to other resources in the document.
  - `meta` object: Non-standard information about the document. Empty unless the endpoint has metadata to convey.

## Other responses

- `400`: The request body or query parameters are invalid, such as an unknown attribute, filter, filter operator, sort field, or sideload.
- `401`: The access token is missing, expired, or not authorized to access this resource.
- `422`: Model validations failed for the resource being created or updated. Unlike this API's other errors, validation failures are returned as a JSON:API errors document locating each invalid field.
- `429`: The access token has exceeded its request quota for the current rate-limit window.

## Changes

- **2026-11-05** `d5c88ca497ac`: 4 breaking, 1 warning, 7 info
  - added `#/components/schemas/create_request_document, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `201`
  - removed the required property `data` from the response with the `201` status
  - …8 more

[Operation history](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/changes/api/v2/event_rsvps/post.md)

---

[API](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api.md) - [All operations](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nationbuilder/apis/nationbuilder-v2-api/revisions/d5c88ca497ac?raw)