Skip to content
Revadike edited this page Nov 5, 2026 · 1 revision

POST /gid/:clanid/ajaxcreateupdatedeletepartnerevents/

Creates, updates, publishes or deletes a partner event of a group. A single endpoint handles all four operations, selected by the mode flags (bCreate, bUpdate, bPublish, bDelete). Requires Steamworks partner access to the group and, for appid, to the app.

Rate limits

No known rate limit

Request

Authenticated: Yes

Method: POST

Host: steamcommunity.com

Path: /gid/:clanid/ajaxcreateupdatedeletepartnerevents/

Variables:

Name Type Description
:clanid number The 64-bit SteamID of the group

Form Data:

Name Type Required Description
sessionid string Yes The value of the sessionid cookie
bCreate number No When 1, creates a new event
bUpdate number No When 1, updates the event identified by gid
bPublish number No When 1, publishes the event identified by gid
bDelete number No When 1, deletes the event identified by gid
gid string No The 64-bit ID of the event (required for bUpdate, bPublish and bDelete)
announcement_gid string No The 64-bit ID of the event's announcement
unlistedmode number No Whether the event is unlisted (1) or listed (0), sent when updating or publishing
rtime32_visibility_start number No Unix timestamp when the event becomes visible
rtime32_visibility_end number No Unix timestamp when the event stops being visible
start_time_is_now number No Whether the event starts immediately (1) or at rtime32_start_time (0)
hidden number No Whether the event is hidden (1) or visible (0), sent when creating
published number No Whether the event is published (1) or a draft (0), sent when creating
appid number No The Steam AppID the event belongs to, sent when creating
event_name string No The event name, sent when creating
event_type number No The numeric event type, sent when creating
body string No The event description (BBCode), sent when creating
rtime32_start_time number No Unix timestamp when the event starts, sent when creating
rtime32_end_time number No Unix timestamp when the event ends, sent when creating
jsondata string No The event's serialized JSON data (fields, links, associated apps and items), sent when creating
tags string No JSON array of the event's tags, sent when creating
build_id number No The ID of the build associated with the event, sent when creating
build_branch string No The build branch associated with the event, sent when creating
broadcaster_accountid number No The 32-bit account ID of the broadcaster, sent when creating an event that has one
:language_headline string No The event name in :language, sent when creating for each localized language (e.g. english_headline)
:language_body string No The event description in :language, sent when creating for each localized language (e.g. english_body)

Response

200 OK

Name Type Description
success number Whether the request was successful
gid string The 64-bit ID of the created event
announcement_gid string The 64-bit ID of the event's announcement
published number Whether the event is published (1) or a draft (0)
hidden number Whether the event is hidden (1) or visible (0)
unlisted number Whether the event is unlisted (1) or listed (0)
forum_topic_id number The ID of the forum topic created for the event
localization_updates[] array Array of the languages whose stored localization was updated
localization_updates[].lang number The language code
localization_updates[].timestamp_updated number Unix timestamp when the language was updated

401 Unauthorized

Name Type Description
success number Whether the request was successful
msg string The error message

Example

POST https://steamcommunity.com/gid/103582791461301431/ajaxcreateupdatedeletepartnerevents/ { sessionid: "a0b1c2d3e4f5g6h7i8j9klmn", bDelete: 1, gid: "1234567890123456789" }
{
    "success": 2,
    "msg": "Access denied, not logged in with sufficient permissions."
}

Clone this wiki locally