Events

Create an event

Routes through the shared Events::Creator, so attendees are notified and the event syncs to a connected Google Calendar. Naive times parse in the company zone. Requires operation events:write.

post/events

Request

Base URL: https://app.fareeqy.com/api/v1
URL: https://app.fareeqy.com/api/v1/events
Auth: HTTP bearer

Request body

namestring required

descriptionstring nullable

starts_atstring required

ISO 8601 (e.g. 2026-07-20T14:00).

ends_atstring required

ISO 8601.

all_dayboolean

meeting_urlstring nullable

attendee_emailsstring[]

Emails of assignable company users to invite.

Response

The created event.

Example response

{
  "data": {
    "id": 77,
    "url": "https://app.fareeqy.com/events/77",
    "name": "اجتماع مراجعة التصاميم",
    "description": "نراجع نسخة الهيدر ونقرر الاتجاه النهائي.",
    "starts_at": "2026-08-05T13:00:00.000+03:00",
    "ends_at": "2026-08-05T14:00:00.000+03:00",
    "all_day": false,
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "organizer": "سارة العتيبي",
    "organizer_email": "sara@example.com",
    "attendees": [
      {
        "name": "عبدالله المطيري",
        "email": "abdullah@example.com"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.