Event Post

📅 Create an Event

Creates an event in your community feed (and optional Spaces). You can set the schedule, time zone, privacy, recurrence, custom buttons and links, and who can see or interact with the event.

Authentication uses an API key issued by Networked.

HTTP Method

POST

Endpoint

https://api.networked.co/events

Headers

Name	Type	Required	Description
x-api-key	string	✅ Yes	Secret API key provided by Networked. Required for authentication.
spaceId	string	❌ No	If provided, the event is associated with the corresponding Space. If omitted, the event is created in the community tied to your API key.
Content-Type	string	✅ Yes	`application/json`

Body Parameters

Name	Type	Required	Description
name	string	✅ Yes	Event title. Minimum 3 characters.
startTime	number	✅ Yes	Event start date and time. See Start and end date below.
endTime	number	✅ Yes	Event end date and time. Must be after `startTime`.
timezone	object	✅ Yes	Time zone for display and recurrence. See Time zone object.
type	number	✅ Yes	Event type (Virtual or In Person). See `EventType` enum.
eventFormatType	number	Conditional	Required when `type` is Virtual (`0`). See `EventFormatType` enum. Omit for In Person events.
settings	object[]	✅ Yes	Who can view and interact with the event. See Settings (privacy & access).
description	string	❌ No	Plain-text or HTML description of the event.
community	string[]	❌ No	Community IDs to publish or collaborate with. If omitted, the community bound to your API key is used.
eventImage	string	❌ No	File ID for a thumbnail or listing image (from the file upload flow).
location	string	❌ No	Physical location for In Person events.
registrationLink	object[]	❌ No	Up to three labeled external URLs (e.g. “Register”, “External link 1”). See Links and attachment.
websiteLink	object	❌ No	Single labeled website URL and button label.
attachmentLink	object	❌ No	File attachment with a button label. Requires a prior file upload.
ctaButtonLayout	object	❌ No	Which buttons appear as Primary, Secondary, and Third on the event card. See Button layout (ctaButtonLayout).
isHideInterestedGoing	boolean	❌ No	Controls RSVP / Respond. `false` = show (default). `true` = hide.
isHideAddToCalender	boolean	❌ No	Controls Add to calendar. `false` = show (default). `true` = hide.
isHideShare	boolean	❌ No	Controls Share. `false` = show (default). `true` = hide.
contactEmail	string	❌ No	Contact email shown on the event.
contactNumber	string	❌ No	Contact phone number shown on the event.
hideFromDiscover	boolean	❌ No	If `true`, the event is hidden from the Discover section on mobile.
recurrenceRule	object	❌ No	How the event repeats. Omit or set `recurrenceType` to `0` for a one-time event. See Recurrence rule.

Start and end date

Topic	Detail
Format	Unix timestamp in milliseconds (same as JavaScript `Date.getTime()`).
startTime	When the event starts.
endTime	When the event ends. Must be after `startTime`.
Time zone	The `timezone` object controls how dates are shown and how recurrence is calculated. Always send `timezone.key` (IANA name, e.g. `Asia/Kolkata`) together with `startTime` and `endTime`.

Example: For “May 8, 2026 12:00 AM” to “12:30 AM” in India Standard Time, convert both instants to millisecond timestamps in that zone, then send those numbers as startTime and endTime.

Time zone object

Field	Type	Required	Description
key	string	✅ Yes	IANA time zone ID (e.g. `Asia/Kolkata`, `America/New_York`). Used for recurrence and display.
value	string	✅ Yes	Human-readable label (e.g. `(GMT +05:30) India Standard Time`).
timezone	string	✅ Yes	Short code or abbreviation (e.g. `IST`).

Example:

{
  "key": "Asia/Kolkata",
  "value": "(GMT +05:30) India Standard Time",
  "timezone": "IST"
}

Settings (privacy & access)

The Privacy dropdown and related access rules are sent as an array of settings entries—one per permission question.

Field	Type	Required	Description
questionId	string	✅ Yes	Permission question ID (`question1` … `question8`).
scope	number	✅ Yes	Who this rule applies to. See `EventScope` enum.
tagArray	string[]	✅ Yes	User role IDs when `scope` is `2` (User role). Use `[]` for other scopes.

Privacy (who can view the event) maps to question1. Typical values:

scope	Meaning (UI)
0	Only me (event creator)
1	Community admins only
2	Specific user roles — must list role IDs in `tagArray`
3	Community members only (common “private to community” choice)
4	Anyone on Networked
5	Anyone on and off Networked

Send the same question1–question8 rows your Networked community uses for events (match the in-app Create Event flow). At minimum, include question1 for privacy.

Example (community members only):

"settings": [
  { "questionId": "question1", "scope": 3, "tagArray": [] }
]

Links and attachment

registrationLink (external links)

Array of up to three objects. Used for labeled external URLs on the event (e.g. registration or custom links).

Field	Type	Required	Description
url	string	✅ Yes	Full URL (https://…).
actionName	string	✅ Yes	Button label shown on the event.

You may also send a row as a plain URL string; it will be normalized to { "url": "..." }.

Index for button layout: first item = registrationLink, second = registrationLink:1, third = registrationLink:2.

websiteLink

Field	Type	Required	Description
url	string	✅ Yes	Website URL.
actionName	string	✅ Yes	Button label.

attachmentLink

Field	Type	Required	Description
fileId	string	✅ Yes	File ID from Networked’s upload API.
actionName	string	✅ Yes	Button label (e.g. `Download`).

Button layout (ctaButtonLayout)

Controls which actions appear as Primary, Secondary, and Third buttons on the event listing and feed post.

Field	Type	Required	Description
primary	string	❌ No	First (primary) button.
secondary	string	❌ No	Second button.
tertiary	string	❌ No	Third button (UI: “Third Button”).

Use null or omit a slot for None. Only assign slots to buttons you have enabled and defined in the request.

Allowed values:

Value	Button
rsvp	RSVP / Respond (requires `isHideInterestedGoing`: `false`)
calendar	Add to calendar (requires `isHideAddToCalender`: `false`)
share	Share (requires `isHideShare`: `false`)
websiteLink	Website link
registrationLink	First item in `registrationLink[]`
registrationLink:1	Second item in `registrationLink[]`
registrationLink:2	Third item in `registrationLink[]`
attachmentLink	Attachment download

Example:

"ctaButtonLayout": {
  "primary": "rsvp",
  "secondary": "calendar",
  "tertiary": "share"
}

Recurrence rule

Omit recurrenceRule, or set recurrenceType to 0, for Does not repeat.

recurrenceType (`EventRecurrenceTypes`)

Value	UI label
0	Does not repeat
1	Daily
2	Weekly on the same weekday as the start date
3	Monthly on the same weekday position (e.g. 2nd Friday)
4	Annually on the same calendar date
5	Every weekday (Monday–Friday)
6	Custom

End conditions (when `recurrenceType` is not `0`)

Field	Type	Required	Description
endsAs	string	✅ Yes	`"date"` — end by calendar date, or `"occurence"` — end after N occurrences (API spelling).
reccurenceEndDate	number	If `endsAs` is `"date"`	Last calendar day on which an occurrence may occur (timestamp or date accepted by your client; align with examples in Apidog recurrence cases).
noOfReccurenceToEnd	number	If `endsAs` is `"occurence"`	Total number of occurrences including the first event.

Custom recurrence only (`recurrenceType`: `6`)

Field	Type	Description
customRecurrenceType	number	`0` Day, `1` Week, `2` Month, `3` Year
repeatFrequency	number	Repeat every N days/weeks/months/years
weekDays	number[]	For weekly custom: days `0` = Sunday … `6` = Saturday
monthlySelectionType	number	`0` = same day of month, `1` = same weekday position each month

Notes:

The first occurrence is always the event at startTime / endTime.

Additional dates are created automatically by Networked.

For detailed payloads (daily, weekly, custom weekdays, etc.), see Event Recurrence Examples in the Reference section below.

Example (daily, end after 10 occurrences):

"recurrenceRule": {
  "recurrenceType": 1,
  "endsAs": "occurence",
  "noOfReccurenceToEnd": 10,
  "reccurenceEndDate": null,
  "customRecurrenceType": null,
  "repeatFrequency": null,
  "weekDays": [],
  "monthlySelectionType": null
}

Enums

EventType

Value	Label
0	Virtual Event
1	In Person

EventFormatType (Virtual events only)

Value	Label
0	Networked Huddle
1	Live
2	External (external meeting link)

EventScope (settings.scope)

Value	Label
0	Only me (creator)
1	Community admins only
2	Specific user roles
3	Community members only
4	Anyone on Networked
5	Anyone on and off Networked

EventWeekDays (custom recurrence weekDays)

Value	Day
0	Sunday
1	Monday
2	Tuesday
3	Wednesday
4	Thursday
5	Friday
6	Saturday

Sample request (virtual event, no recurrence)

{
  "name": "Weekly Community Meetup",
  "startTime": 1746648000000,
  "endTime": 1746651600000,
  "type": 0,
  "eventFormatType": 0,
  "timezone": {
    "key": "Asia/Kolkata",
    "value": "(GMT +05:30) India Standard Time",
    "timezone": "IST"
  },
  "description": "Join us for updates and Q&A.",
  "settings": [
    { "questionId": "question1", "scope": 3, "tagArray": [] },
    { "questionId": "question2", "scope": 3, "tagArray": [] },
    { "questionId": "question3", "scope": 3, "tagArray": [] },
    { "questionId": "question4", "scope": 3, "tagArray": [] },
    { "questionId": "question5", "scope": 3, "tagArray": [] },
    { "questionId": "question6", "scope": 3, "tagArray": [] },
    { "questionId": "question7", "scope": 3, "tagArray": [] },
    { "questionId": "question8", "scope": 3, "tagArray": [] }
  ],
  "isHideInterestedGoing": false,
  "isHideAddToCalender": false,
  "isHideShare": false,
  "ctaButtonLayout": {
    "primary": "rsvp",
    "secondary": "calendar",
    "tertiary": "share"
  },
  "recurrenceRule": {
    "recurrenceType": 0,
    "endsAs": "date",
    "reccurenceEndDate": null,
    "noOfReccurenceToEnd": null,
    "customRecurrenceType": null,
    "repeatFrequency": null,
    "weekDays": [],
    "monthlySelectionType": null
  }
}

Sample Response

{
  "data": {
    "eventId": "6855529c78bddf001282dd01",
    "status": 1
  },
  "error": false,
  "message": "Success"
}

Response Interface

interface CreateEventResponse {
  data: {
    eventId: string;
    status: number;
  };
  error: boolean;
  message: string;
}

Response Field Descriptions

Field	Type	Description
eventId	string	Unique ID of the newly created event.
status	number	`1` = Accepted (published). `5` = Pending (awaiting community moderation approval).
error	boolean	`false` indicates the API call was successful.
message	string	Message confirming the result of the request.

Reference

Standard Response Codes Reference

Event List (GET /events) — list and fetch events with the same API key

Event Recurrence Examples — see recurrence case documents in this Apidog project (daily, weekly, monthly, custom, etc.)

Notes

Store your API key securely. Networked issues keys per community; contact Networked support for a new key if needed.

Upload banner, image, and attachment files through Networked’s file upload flow first; then pass the returned IDs in eventBanner, eventImage, or attachmentLink.fileId.

For Virtual events, eventFormatType is required. Huddle (0) and Live (1) create an in-app meeting room automatically.

Toggle fields (isHideInterestedGoing, etc.) are inverted: false means the button is visible.

Use header spaceId when the event should belong to a Space; otherwise it defaults to your key’s community.

Optional fields may be omitted when not used; do not send placeholder objects for links you are not using.

Rate limits apply to API key requests. Retry with backoff if you receive a rate-limit response.

📅 Create an Event

HTTP Method

Endpoint

Headers

Body Parameters

Start and end date

Time zone object

Settings (privacy & access)

Links and attachment

registrationLink (external links)

websiteLink

attachmentLink

Button layout (ctaButtonLayout)

Recurrence rule

recurrenceType (`EventRecurrenceTypes`)

End conditions (when `recurrenceType` is not `0`)

Custom recurrence only (`recurrenceType`: `6`)

Enums

EventType

EventFormatType (Virtual events only)

EventScope (settings.scope)

EventWeekDays (custom recurrence weekDays)

Sample request (virtual event, no recurrence)

Sample Response

Response Interface

Response Field Descriptions

Reference

Notes

Request

Responses

Event Post

📅 Create an Event#

HTTP Method#

Endpoint#

Headers#

Body Parameters#

Start and end date#

Time zone object#

Settings (privacy & access)#

Links and attachment#

registrationLink (external links)#

websiteLink#

attachmentLink#

Button layout (ctaButtonLayout)#

Recurrence rule#

recurrenceType (EventRecurrenceTypes)#

End conditions (when recurrenceType is not 0)#

Custom recurrence only (recurrenceType: 6)#

Enums#

EventType#

EventFormatType (Virtual events only)#

EventScope (settings.scope)#

EventWeekDays (custom recurrence weekDays)#

Sample request (virtual event, no recurrence)#

Sample Response#

Response Interface#

Response Field Descriptions#

Reference#

Notes#

Request

Responses

📅 Create an Event

HTTP Method

Endpoint

Headers

Body Parameters

Start and end date

Time zone object

Settings (privacy & access)

Links and attachment

registrationLink (external links)

websiteLink

attachmentLink

Button layout (ctaButtonLayout)

Recurrence rule

recurrenceType (`EventRecurrenceTypes`)

End conditions (when `recurrenceType` is not `0`)

Custom recurrence only (`recurrenceType`: `6`)

Enums

EventType

EventFormatType (Virtual events only)

EventScope (settings.scope)

EventWeekDays (custom recurrence weekDays)

Sample request (virtual event, no recurrence)

Sample Response

Response Interface

Response Field Descriptions

Reference

Notes