Hubs

Add Event To Hub Agenda

Put a live event on your hub's agenda.

The event may belong to any host. It must be live, public and not unlisted, and it cannot itself be a hub. Adding is immediate, with no review step, and the added event's hosts are emailed that a hub picked their event up.

The hub's own status, isPublic and unlisted decide whether the hub is LISTED publicly, not whether its agenda can be read. A live private or unlisted hub is link-only, and its schedule is readable by anyone holding that link, so adding is visible immediately rather than staged. Only a draft hub is unreachable from its own page, and hubs are curatable before they go live on purpose, so adding to one is not an error. GET /v1/hubs reports all three fields (status, isPublic, unlisted).

The notification runs after the change is committed and swallows delivery failures, so it is not a guarantee that the added event's hosts learn of the change before the public can see it.

post/v1/hubs/{hub_slug}/events

Request

  • Base URL: https://developer.eventship.com (the document declares no server; this is the origin it was published from)
  • URL: https://developer.eventship.com/v1/hubs/{hub_slug}/events
  • Auth: API key in header X-API-Key

Path parameters

hub_slugstring required

Request body

eventSlugstring required

URL slug of the event to add. It may belong to any host, not just yours, but it must be live, public and not unlisted.

Response

Successful Response

successboolean
messagestring nullable

Changes

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