For the complete documentation index, see llms.txt. This page is also available as Markdown.

Events

Events live at /v2/events. They support every request on the Records page: list, get, history, create, update, delete and search.

Creating an event

curl -X POST "https://api.tiny.plus/v2/events" \
  -H "Authorization: Bearer {{user_access_token}}" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Industry breakfast",
        "event_type": "hosted",
        "event_date": "2026-10-20 21:30:00",
        "event_date_end": "2026-10-20 23:00:00",
        "event_url": "https://example.com/breakfast",
        "assigned_user": "1231"
      }'
{
    "id": "161085"
}
  • name, event_type and event_date are required. event_type is hosted or external.

  • Send event_date and event_date_end in UTC. They come back in UTC too.

  • A new event's record_status is upcoming. Once the event is over, tiny+ marks it as held.

  • event_location is an address. Send it in parts, like a company's address: event_location_address1, event_location_town and so on. See Addresses.

Attendees and RSVPs

You can read who's coming to an event:

  • attendees_json is the guest list, as a JSON-encoded string. Each guest has name, email, company, mobile, notes, related_contact and related_company.

  • staff_rsvps lists the team members who have said they're coming, as ids separated by |, such as "1231|1245".

Manage attendees and RSVPs in tiny+.

Fields

Field
Label in tiny+
Type
Notes
Editable

allow_staff_rsvp

Team members can RSVP?

Yes/no

1 if team members can say they're coming.

Records admins only

assigned_user

Assigned To

Team member id

A team member's id.

Yes

attendees_json

Attendees

JSON

The guest list, as a JSON-encoded string. See Attendees and RSVPs.

No

description

Event Description

Text

Yes

event_date

Event Date

Date-time

Required. In UTC.

Yes

event_date_end

Event End Date

Date-time

In UTC.

Yes

event_location

Event Location

Address

An address. Send it in parts: see Addresses. Reads return event_location_address1 to event_location_country, and event_location_geo_lat and event_location_geo_lng.

Yes

event_type

Event Type

Option

Required. hosted or external.

Yes

event_url

External Link

URL

Yes

name

Event Name

Text

Required. Up to 200 characters.

Yes

record_status

Event Status

Option

upcoming unless you send another.

Yes

staff_max_rsvps

RSVP Slots

Whole number

How many team members can say they're coming.

Yes

staff_rsvps

RSVPs

Team member ids

The ids of team members coming, separated by |.

No

Last updated

Was this helpful?