Skip to main content
Version: v2

Create Event​

Creates one event with the specified details.

Header Parameters
    Idempotency-Key string optional

    Optional header for making the request idempotent

Request Body required
    user object optional

    The user identifier.

    If session.id is provided, the session.id is enough to identify a session for which to create the event, and user will not be accepted.

    If session.use_most_recent is set to true, one and only oneuser field is required.

    uid string optional

    Possible values: <= 256 characters

    The application-specific ID you've given to the user.

    id string optional

    The Fullstory-assigned user ID. This value is returned in a POST /v2/users (create user) response.

    session object optional

    The session identifier.

    id string optional

    The Fullstory generated identifier for the session to associate the event with.

    use_most_recent boolean optional

    Associate events with the most recent session captured from the user.

    If set to true, a user is required. The user must have a session within the past 30 minutes, otherwise the events will be created for the user without a session.

    It is recommended to use session.id instead, when creating events for a specific session.

    uid string optional

    Possible values: <= 256 characters

    The application-specific ID you've given to the session.

    context object optional

    The context in which the events are attached to.

    browser object optional

    The browser context in which the events are attached to.

    url string optional
    user_agent string optional
    initial_referrer string optional
    mobile object optional

    The mobile context in which the events are attached to.

    app_id string optional
    app_version string optional
    app_name string optional
    build_variant string optional
    device object optional

    The device context in which the events are attached to.

    manufacturer string optional
    model string optional
    screen_width int32 optional
    screen_height int32 optional
    viewport_width int32 optional
    viewport_height int32 optional
    location object optional

    The location context in which the events are attached to.

    country string optional

    ISO 3166-1 alpha-2 standard country code.

    region string optional

    ISO-3166-2 standard region code.

    city string optional

    Name of the city.

    latitude double optional
    longitude double optional
    ip_address string optional
    name string required

    The event's name.

    timestamp ISO 8601 string optional

    Optional. The event's timestamp represented in ISO 8601 format. If not provided, the current Fullstory server time will be used. It is recommended to always set the timestamp.

    properties object optional

    Optional. The custom event's payload.

    schema object optional

    Optional. Schema declaration, to define the structure of the data, the schema will override Fullstory's default type inference.

    properties object optional

    A mapping of field names to their corresponding types.

Responses
200

A successful response.

{}
Loading...