Events

Warning

Deprecation Notice: The Marketing Version 202511 (Marketing November 2025) will be sunset on November 16, 2026. We recommend that you migrate to the latest versioned APIs to avoid disruptions. For information on all the supported versions, refer to the migrations documentation. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

Events have been an important approach for companies to attract leads and make conversions. Event organizers leverage the events platform at LinkedIn to create event pages where members can register to attend events, join live stream online events, and participate in the post-event activities. At the same time, attendees discover relevant events, make new connections, and nurture existing relationships on the platform.

Permissions

Access to the LinkedIn Marketing API Program doesn't automatically grant access to the following APIs. Developers must apply separately to be considered for these APIs.

Permission Description
r_events Retrieve an organization’s events. Restricted to organizations where the authenticated member holds one of the following company page roles:
  • ADMINISTRATOR
  • CONTENT_ADMINISTRATOR
rw_events Modify an organization's events. This is restricted to organizations where the authenticated member holds one of the following company page roles:
  • ADMINISTRATOR
  • CONTENT_ADMINISTRATOR

See Organization Access Control for more information on company page roles.

Note

All API requests are represented in protocol 2.0.0 and require the header X-Restli-Protocol-Version: 2.0.0.

Schemas

Events

Field Type Description Mutability
id Long Unique identifier of the event. READ ONLY
created AuditStamp Timestamp and actor recorded when the event was created. READ ONLY
lastModified AuditStamp Timestamp and actor recorded when the event was last modified. READ ONLY
name MultiLocaleString Name of the event as provided by the creator. Updatable
description MultiLocaleRichText Description of the event as provided by the creator. Not present if no description was provided. Updatable
type OnlineEventType or InPersonEventType Whether the event is online or in-person. The top-level type discriminator and format cannot be changed after creation; only sub-fields within the chosen type (such as endsAt, url, address, venueDetails) can be updated. CREATE ONLY
organizer URN Entity responsible for organizing this event. Accepted URN types: urn:li:person:{id}, urn:li:organization:{id}. Cannot be changed after creation. CREATE ONLY
vanityName String URL-friendly identifier unique across all events, useful for SEO. Updatable
startsAt Long Start time of the event in epoch millis. Updatable
backgroundImage DigitalmediaAssetUrn Background image for the event. If not provided, a default image is used. Updatable
leadGenFormSpec LeadGenFormSpec Specifies how to attach a lead generation form to the event. Can only be set at creation — cannot be updated afterward. CREATE ONLY
leadGenForm VersionedLeadGenFormUrn The lead generation form attached to this event. System-generated from leadGenFormSpec. READ ONLY
discoveryMode EventDiscoveryMode Controls how the event can be discovered on LinkedIn. Possible values: LISTED (discoverable through search, recommendations, and other LinkedIn channels), URL_ONLY (only accessible via direct URL). Updatable
ugcPost UserGeneratedContentPostUrn URN of the LinkedIn post associated with this event. Set automatically when the event is posted. READ ONLY

The following additional field is available from API version 202605 and later:

Field Type Description Mutability
hasDarkUgc Boolean When true, the event is backed only by a dark UGC post created through sponsored ad workflows. The event has no LinkedIn Events Detail Page and is suppressed from all organic surfaces regardless of discoveryMode. Default: false. CREATE ONLY

Note

For events with hasDarkUgc: true, organic visibility is suppressed by hasDarkUgc at the platform level regardless of the discoveryMode field.

Important

All Updatable fields can only be modified while the event has not yet started (i.e., startsAt is in the future). Once an event has started or ended, no fields can be updated. Refer to Update an Event for full lifecycle restrictions.

OnlineEventType

This schema describes an event held virtually.

Field Type Description Mutability
format LiveVideo or External Indicates whether the event is streamed on LinkedIn or streamed from an external website. CREATE ONLY
LiveVideo

This schema represents a live event streamed on LinkedIn.

Field Type Description Mutability
endsAt Long The end time of the event in epoch millis. Updatable
liveVideo LiveVideoUrn Identifier of the live video, automatically generated upon event creation. Present only in CREATE responses. READ ONLY
testEvent Boolean If true, the event is treated as a test event visible only to that organization's admins. The default value is set to false.
NOTE: The testEvent can only be set at creation.		 CREATE ONLY
External

This schema represents an event streamed on an external website.

Field Type Description Mutability
endsAt Long The end time of the event in epoch millis. Updatable
url URL The URL of the external page where the event is hosted. Updatable

InPersonEventType

This schema describes an event held at a physical location.

Field Type Description Mutability
endsAt Long The end time of the event in epoch millis. Updatable
address Address The address of the event's venue. Updatable
url URL URL of a page external to LinkedIn that contains information on the event. Updatable
venueDetails MultiLocaleRichText Additional details about the event venue. Updatable

LeadGenFormSpec

A union that specifies how to attach a lead generation form to an event during its creation.

The following table provides the union's possible values:

Attribute Type Description Required
privacyPolicyUrl URL Attaches a lead generation form, generated from a pre-defined template, to the event. Optional
leadGenForm VersionedLeadGenFormUrn Attaches the pre-existing lead generation form to the event. This lead generation form must already be approved. Optional

Note

These attributes are optional. Providing both attributes will result in a 422 error from the API.

Operations

Create an Event

Creating an event can be a one-step or three-step process, depending on whether a custom background image is included during setup. Optionally, you can create a background image asset. Refer to this section for more information.

Without a custom background image

Create the event directly using the Create Event examples.

With a custom background image

Follow these steps to create an event with a custom background image:

  1. Register an upload.
  2. Upload a background image. Refer to the upload section.
  3. Create an event.

After creating an event, you must post it using the Posts API to make it publicly visible on LinkedIn.

Follow these steps to create an event with a custom background image:

  1. Register an upload.
  2. Upload a background image. Refer to the upload section.
  3. Create an event.

After creating an event, you must post it using the Posts API to make it publicly visible on LinkedIn. For off-platform events created with hasDarkUgc: true, a dark post is still required but is created as part of the Event Ads workflow with feedDistribution: NONE. These events are not visible on organic surfaces.

Create Background Image Asset

Following is an example of the two-step process for creating a background image asset:

  1. Register an upload.
  2. Upload an image.
Register Upload

The asset property in the response is a URN that uniquely identifies the background image uploaded in the subsequent step.

Sample Request
POST https://api.linkedin.com/rest/assets?action=registerUpload

{
    "registerUploadRequest": {
        "owner": "urn:li:person:3S98trzt4Ku",
        "recipes": [
            "urn:li:digitalmediaRecipe:event-background-image"
        ],
        "serviceRelationships": [
            {
                "identifier": "urn:li:userGeneratedContent",
                "relationshipType": "OWNER"
            }
        ],
        "supportedUploadMechanism": [
            "SYNCHRONOUS_UPLOAD"
        ]
    }
}
Sample Response

HTTP/1.1 200 OK

{
    "value": {
        "mediaArtifact": "urn:li:digitalmediaMediaArtifact:(urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q,urn:li:digitalmediaMediaArtifactClass:uploaded-image)",
        "uploadMechanism": {
            "com.linkedin.digitalmedia.uploading.MediaUploadHttpRequest": {
                "uploadUrl": "https://api.linkedin-ei.com/mediaUpload/sp/sync/D5522AQEFM6ArFzip2Q/uploaded-image/0?ca=vector_feedshare&cn=uploads&m=AQLJddCQmalNqwAAAZJyuIrtiqodKbVmtsUecAh5N02nWs9_GV6VcNVG6Q&app=11700002&sync=1&v=beta&ut=0gpoRJPpiDBbs1",
                "headers": {
                    "media-type-family": "STILLIMAGE"
                }
            }
        },
        "asset": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q",
        "assetRealTimeTopic": "urn:li-realtime:digitalmediaAssetUpdatesTopic:urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
    }
}
Upload

Use the uploadUrl from the response of the previous step to upload a background image.

Sample Request
POST https://api.linkedin.com/mediaUpload/sp/sync/D5522AQEFM6ArFzip2Q/uploaded-image/0?ca=vector_feedshare&cn=uploads&m=AQLJddCQmalNqwAAAZJyuIrtiqodKbVmtsUecAh5N02nWs9_GV6VcNVG6Q&app=11700002&sync=1&v=beta&ut=0gpoRJPpiDBbs1
Sample Response

HTTP/1.1 201 Created

Create Event

Following are the examples of creating various types of events:

Live Video Event Example

A live video event is an event that one streams on LinkedIn.

Sample Request
POST https://api.linkedin.com/rest/events

{
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "type": {
        "online": {
            "format": {
                "liveVideo": {
                    "endsAt": 9091536065000
                }
            }
        }
    },
    "organizer": "urn:li:organization:7185861",
    "leadGenFormSpec": {
        "privacyPolicyUrl": "https://kneelbeforezod.com"
    },
    "startsAt": 9091536064111,
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}
Sample Response

HTTP/1.1 201 Created

{
    "vanityName": "testonlineevent7249811611689828352",
    "discoveryMode": "LISTED",
    "leadGenForm": "urn:li:versionedLeadGenForm:(urn:li:leadGenForm:7249811611534639104,1)",
    "created": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728489783272
    },
    "organizer": "urn:li:organization:7185861",
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "startsAt": 9091536064111,
    "id": 7249811611689828352,
    "lastModified": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728489783272
    },
    "type": {
        "online": {
            "format": {
                "liveVideo": {
                    "endsAt": 9091536065000,
                    "liveVideo": "urn:li:liveVideo:7249811612692275200"
                }
            }
        }
    },
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}
External Event Example

An external event is an event hosted on a site other than LinkedIn.

Sample Request
POST https://api.linkedin.com/rest/events

{
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "type": {
        "online": {
            "format": {
                "external": {
                    "endsAt": 9091536065000,
                    "url": "https://cometomesonofjorel.com"
                }
            }
        }
    },
    "organizer": "urn:li:organization:7185861",
    "leadGenFormSpec": {
        "privacyPolicyUrl": "https://kneelbeforezod.com"
    },
    "startsAt": 9091536064111,
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}
Sample Response

HTTP/1.1 201 Created

{
    "vanityName": "testonlineevent7249812147952566272",
    "discoveryMode": "LISTED",
    "leadGenForm": "urn:li:versionedLeadGenForm:(urn:li:leadGenForm:7249812147889659904,1)",
    "created": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728489911114
    },
    "organizer": "urn:li:organization:7185861",
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "startsAt": 9091536064111,
    "id": 7249812147952566272,
    "lastModified": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728489911114
    },
    "type": {
        "online": {
            "format": {
                "external": {
                    "endsAt": 9091536065000,
                    "url": "https://cometomesonofjorel.com"
                }
            }
        }
    },
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}
In-person Event Example

An in-person event is an event held at a physical address.

Sample Request
POST https://api.linkedin.com/rest/events

{
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "type": {
        "inPerson": {
            "endsAt": 9091536065000,
            "url": "https://cometomesonofjorel.com",
            "address": { }
        }
    },
    "organizer": "urn:li:organization:7185861",
    "leadGenFormSpec": {
        "privacyPolicyUrl": "https://kneelbeforezod.com"
    },
    "startsAt": 9091536064111,
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}
Sample Response

HTTP/1.1 201 Created

{
    "vanityName": "testonlineevent7249812613549670400",
    "discoveryMode": "LISTED",
    "leadGenForm": "urn:li:versionedLeadGenForm:(urn:li:leadGenForm:7249812613490958336,1)",
    "created": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728490022117
    },
    "organizer": "urn:li:organization:7185861",
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "startsAt": 9091536064111,
    "id": 7249812613549670400,
    "lastModified": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728490022117
    },
    "type": {
        "inPerson": {
            "address": {},
            "endsAt": 9091536065000,
            "url": "https://cometomesonofjorel.com"
        }
    },
    "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q"
}

Post an Event

After creating an event, post it using the Posts API to make it publicly visible on LinkedIn. The content reference URN to use depends on the event type as follows:

After creating an event, post it using the Posts API to make it publicly visible on LinkedIn. For off-platform events created with hasDarkUgc: true, a dark post is still required but is created as part of the Event Ads workflow with feedDistribution: NONE. These events are not visible on organic surfaces. The content reference URN to use depends on the event type:

Event type Content reference URN
Live video urn:li:liveVideo:{liveVideo} — use the type.online.format.liveVideo.liveVideo value from the create response.
External urn:li:event:{id} — use the id value from the create response.
In-person urn:li:event:{id} — use the id value from the create response.

Note

An event cannot be fetched via GET /rest/events/{id} or updated via POST /rest/events/{id} (partial update) until it has been successfully posted.

Live Video Event Example

In this example, use the type.online.format.liveVideo.liveVideo value from the create response as the content reference.

Sample Request
POST https://api.linkedin.com/rest/posts

{
    "author": "urn:li:organization:7185861",
    "commentary": "",
    "visibility": "PUBLIC",
    "distribution": {
        "feedDistribution": "MAIN_FEED",
        "targetEntities": [],
        "thirdPartyDistributionChannels": []
    },
    "content": {
        "reference": {
            "id": "urn:li:liveVideo:7249811612692275200"
        }
    },
    "lifecycleState": "PUBLISHED",
    "isReshareDisabledByAuthor": false
}
Sample Response

HTTP/1.1 201 Created

Note

  • No response body is returned.
  • The ID of the created post is provided in the x-restli-id response header.

External and In-person Event Example

For external (off-platform) and in-person events, use the event id from the create response to construct the content reference URN: urn:li:event:{id}.

Sample Request
POST https://api.linkedin.com/rest/posts

{
    "author": "urn:li:organization:7185861",
    "commentary": "",
    "visibility": "PUBLIC",
    "distribution": {
        "feedDistribution": "MAIN_FEED",
        "targetEntities": [],
        "thirdPartyDistributionChannels": []
    },
    "content": {
        "reference": {
            "id": "urn:li:event:7249812147952566272"
        }
    },
    "lifecycleState": "PUBLISHED",
    "isReshareDisabledByAuthor": false
}
Sample Response

HTTP/1.1 201 Created

Note

  • No response body is returned.
  • The ID of the created post is provided in the x-restli-id response header.

Fetch an Event

An event is not fetchable until one posts that event.

Sample Request

The last component of the URL path is the ID of the event to fetch.

GET https://api.linkedin.com/rest/events/7246559654799892480
Sample Response

HTTP/1.1 200 OK

{
    "vanityName": "kneelbeforezodyetagain",
    "discoveryMode": "URL_ONLY",
    "ugcPost": "urn:li:ugcPost:7246780305028571136",
    "created": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1727714456443
    },
    "organizer": "urn:li:organization:7185861",
    "name": {
        "localized": {
            "en_US": "test online event"
        }
    },
    "startsAt": 9091536064111,
    "id": 7246559654799892480,
    "lastModified": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1728493578344
    },
    "type": {
        "online": {
            "format": {
                "liveVideo": {
                    "endsAt": 9091536065000
                }
            }
        }
    }
}

Update an Event

An event cannot be updated until it has been posted. Events are updated using a partial update request (POST with X-RestLi-Method: partial_update). The last component of the URL path is the ID of the event to update.

Field mutability

Not all event fields can be updated after creation. The following table summarizes the three mutability categories:

Category Fields Behavior
READ ONLY id, created, lastModified, ugcPost, leadGenForm, type.online.format.liveVideo.liveVideo Never settable by partners. Any attempt to include these in a partial update is rejected.
CREATE ONLY organizer, type (online vs. in-person discriminator), type.online.format (liveVideo or external discriminator), leadGenFormSpec, type.online.format.liveVideo.testEvent Can be set at creation but cannot be changed afterward. Do not include these fields in partial updates to change their value.
Updatable name, description, vanityName, startsAt, backgroundImage, discoveryMode, and type sub-fields: endsAt, url, address, venueDetails Can be changed after creation, subject to the lifecycle restrictions below.

Note

From API version 202605 and later, hasDarkUgc is also a CREATE ONLY field.

Lifecycle restrictions

The lifecycle state of an event determines whether any update is permitted:

Event state Condition Update behavior
Upcoming startsAt is in the future All updatable fields can be updated.
Ongoing or past startsAt ≤ current time No fields can be updated. Returns HTTP 400: Event cannot be modified once it has started.
Cancelled Event has been cancelled No fields can be updated. Returns HTTP 403: No updates can be made to cancelled event.

Note

The "started" check is based solely on whether the original startsAt has passed. This restriction applies to all fields, not just time-related fields. Attempting to update name, description, or any other field after this time will result in an HTTP 400 error.

Example

The following examples update all updatable fields. Replace the event id, timestamps, and field values with your own. The type sub-fields available depend on the event type:

  • In-person:

    • type.inPerson.endsAt
    • type.inPerson.url
    • type.inPerson.address
    • type.inPerson.venueDetails

  • External online:

    • type.online.format.external.endsAt
    • type.online.format.external.url

  • Live video:

    • type.online.format.liveVideo.endsAt

Note

The type discriminator (inPerson vs online) is CREATE ONLY and cannot be changed after creation. When including type in a partial update, the member key in the patch (inPerson, online) must match the event's existing type. Use it only to update nested sub-fields such as endsAt, url, address, and venueDetails. Do not attempt to change the type discriminator.

In-person event
Sample Request
POST https://api.linkedin.com/rest/events/7246559654799892480
X-RestLi-Method: partial_update

{
    "patch": {
        "$set": {
            "name": {
                "localized": {
                    "en_US": "Updated In-Person Event Name"
                }
            },
            "description": {
                "localized": {
                    "en_US": {
                        "rawText": "Updated description with the latest event details."
                    }
                }
            },
            "vanityName": "updated-event-2026",
            "startsAt": 1773568800000,
            "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q",
            "discoveryMode": "LISTED",
            "type": {
                "inPerson": {
                    "endsAt": 1773576000000,
                    "url": "https://example.com/event-info",
                    "address": {
                        "line1": "123 Main Street",
                        "city": "San Francisco",
                        "geographicArea": "California",
                        "postalCode": "94105",
                        "country": "US"
                    },
                    "venueDetails": {
                        "localized": {
                            "en_US": {
                                "rawText": "Building A, Room 101"
                            }
                        }
                    }
                }
            }
        }
    }
}
Sample Response

HTTP/1.1 200 OK

External online event
Sample Request
POST https://api.linkedin.com/rest/events/7246559654799892480
X-RestLi-Method: partial_update

{
    "patch": {
        "$set": {
            "name": {
                "localized": {
                    "en_US": "Updated Online Event Name"
                }
            },
            "description": {
                "localized": {
                    "en_US": {
                        "rawText": "Updated description with the latest event details."
                    }
                }
            },
            "vanityName": "updated-online-event-2026",
            "startsAt": 1773568800000,
            "backgroundImage": "urn:li:digitalmediaAsset:D5522AQEFM6ArFzip2Q",
            "discoveryMode": "LISTED",
            "type": {
                "online": {
                    "format": {
                        "external": {
                            "endsAt": 1773576000000,
                            "url": "https://example.com/livestream"
                        }
                    }
                }
            }
        }
    }
}
Sample Response

HTTP/1.1 200 OK

Delete an Event

An event can't be deleted until it's posted.

Delete a posted event by deleting its associated post. See the Posts API documentation for more details.

Example

Sample Request

Note

The last component of the URL path is the URL-encoded URN of the post to be deleted.

DELETE https://api.linkedin.com/rest/posts/urn%3Ali%3AugcPost%3A7246780305028571136
Sample Response

HTTP/1.1 204 No Content

Find Events by Organizer

Query Parameters

Parameter Type Description Required Default Value
organizer PersonUrn or OrganizerUrn The organizer of each event that this endpoint yields is equal to this value. Yes
start Integer The index of the first event to return. No 0
count Integer The endpoint maximizes the number of events that it returns such that the number doesn't exceed this value. No 10
excludeCancelled Boolean If true, then the endpoint excludes cancelled events from the pool of candidates to return. No false
timeBasedFilter EventTimeBasedFilter Temporally restricts the pool of candidate events to return. No
entryCriteria EventEntryCriteria Restricts the candidate events to return to those only whose entry criteria matches this value. No
sortOrder EventSortOrder Specifies the order of the candidate events to return. No

Schemas

EventTimeBasedFilter

A union with the following definitions:

Key Type Description Sample Value
lifeCycleState EventLifeCycleState Enumerates the states of an event's life cycle: UPCOMING, ONGOING, or PAST {"lifeCycleState":"ONGOING"}
ongoingTimeRange ClosedTimeRange A closed interval of timestamps [start, end]. {"ongoingTimeRange":{"start":1, "end":2}}
startTimeRange TimeRange An open or semi-open interval of timestamps: (-∞, ∞), [start, ∞), or (-∞, end), or [start, end) {"startTimeRange":{"start":1, "end":2}}
EventEntryCriteria

An enumeration with the following possible values:

Value Description
PUBLIC Denotes a public event.
GATED Denotes a gated event.
EventSortOrder

An enumeration with the following possible values:

Value Description
START_TIME_ASC Sorts events in ascending order based on their start time.
END_TIME_DESC Sorts events in descending order based on their end time.

Example

Note

Do not URL-encode the timeBasedFilter parameter or its nested fields in your request. For example, use timeBasedFilter=(startTimeRange:(start:1741600500,end:1771062900)) or timeBasedFilter=(lifeCycleState:PAST) directly in the query string.

Sample Request
GET https://api.linkedin.com/rest/events?q=eventsByOrganizer&organizer=urn%3Ali%3Aorganization%3A7185861&start=0&count=10&excludeCancelled=true&timeBasedFilter=(lifeCycleState:PAST)&entryCriteria=PUBLIC&sortOrder=END_TIME_DESC
Sample Response

HTTP/1.1 200 OK

{
    "elements": [
        {
            "vanityName": "testliveevent7130245568970252288",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699983017337
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130245568970252288,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699983017337
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130245292590788608",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699982951398
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130245292590788608,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699982951398
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130245111300386816",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699982908195
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130245111300386816,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699982908195
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130085076381364224",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944753112
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130085076381364224,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944753112
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084947838529536",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944722223
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084947838529536,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944722223
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084808772182016",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944689146
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084808772182016,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944689146
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084664915947520",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944654766
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084664915947520,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944654766
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084640249241600",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944648888
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084640249241600,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944648888
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084608682909696",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944641362
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084608682909696,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944641362
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        },
        {
            "vanityName": "testliveevent7130084539053268992",
            "discoveryMode": "LISTED",
            "ugcPost": "urn:li:ugcPost:7044751230899736576",
            "created": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944624911
            },
            "organizer": "urn:li:organization:7185861",
            "name": {
                "localized": {
                    "en_US": "test live event"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startsAt": 1708749167000,
            "id": 7130084539053268992,
            "lastModified": {
                "actor": "urn:li:person:vU6QAVEtcr",
                "time": 1699944624911
            },
            "type": {
                "online": {
                    "format": {
                        "liveVideo": {}
                    }
                }
            }
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 0,
        "links": [
            {
                "rel": "next",
                "type": "application/json",
                "href": "/events?q=eventsByOrganizer&timeBasedFilter=(lifeCycleState:PAST)&organizer=urn%3Ali%3Aorganization%3A7185861&sortOrder=END_TIME_DESC&start=10&count=10&entryCriteria=PUBLIC&excludeCancelled=true"
            }
        ]
    }
}

Find Events with Lead Gen Form by Organizer

This endpoint returns all the lead generation form enabled events organized by a particular organization. This endpoint requires q=organizerLeadGenFormEnabledEvents and organization URN in the organizer parameter.

Since an organization can have a large volume of Events, this API supports pagination using the count and start parameters.

Parameter Type Description
q String You must always set this to organizerLeadGenFormEnabledEvents. It indicates that you're querying based on organizerLeadGenFormEnabledEvents.
organizer OrganizationUrn URN identifying the organizer of the event. This is the organization.
count Integer How many results to display on each page.
start Integer The index of the form to begin your result page at. Indexes start at 0. Default is 0.

Example

Sample Request
GET https://api.linkedin.com/rest/events?organizer=urn%3Ali%3Aorganization%3A7185861&start=0&count=2&q=organizerLeadGenFormEnabledEvents
Sample Response

HTTP/1.1 200 OK

{
  "elements": [
    {
      "vanityName": "testonlineevent7254255946724425728",
      "discoveryMode": "LISTED",
      "leadGenForm": "urn:li:versionedLeadGenForm:(urn:li:leadGenForm:7254255946464378880,1)",
      "ugcPost": "urn:li:ugcPost:7254256112596574208",
      "created": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1729549395432
      },
      "organizer": "urn:li:organization:7185861",
      "name": {
        "localized": {
          "en_US": "test online event"
        }
      },
      "startsAt": 9091536064111,
      "id": 7254255946724426000,
      "lastModified": {
        "actor": "urn:li:person:vU6QAVEtcr",
        "time": 1729549395432
      },
      "type": {
        "online": {
          "format": {
            "liveVideo": {
              "endsAt": 9091536065000
            }
          }
        }
      }
    }
  ],
  "paging": {
    "count": 2,
    "start": 0,
    "total": 0,
    "links": [
      {
        "rel": "next",
        "type": "application/json",
        "href": "/events?organizer=urn%3Ali%3Aorganization%3A7185861&start=2&count=2&q=organizerLeadGenFormEnabledEvents"
      }
    ]
  }
}
  • Last updated on