Organizations and Brands Overview

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

Use the Organizations and Brand APIs to create, update, and delete your organization and brand information. This API supports view analytics, notifications, and share content. You can also enable members to follow organizations and view suggested organizations.

Unless otherwise specified, authenticated members must be assigned specific organization roles to use endpoints that retrieve, create, or modify an organization or its related data.

Organizational Entities

URNs uniquely identify organizational entities and can be generated with existing company or showcase IDs.

Both resources share common fields and similarities in how data is accessed, and may only be modified by members who have been granted specific Organization Roles.

Page Organizational Entity URN
Company Pages Organization urn:li:organization:{company id}
Showcase Pages Brand urn:li:organizationBrand:{showcase id}

Resources

Organization Statistics and Analytics

You must be an authenticated member with role type ADMINISTRATOR for an organization to make the following API calls:

Test Organizations

LinkedIn offers two dedicated organizations for testing and you do not need the ADMINISTRATOR role to make API calls to these organizations.

Warning

Anyone can view shares posted to a test organization. When you post shares, make sure to exclude information that should not be public.

Name URL Organization URN
DevTestCo https://www.linkedin.com/company/devtestco/ urn:li:organization:2414183
Test University http://www.linkedin.com/school/6177438 urn:li:organization:6177438

Important

Notwithstanding anything to the contrary in the Microsoft Terms of Use and Microsoft Privacy Statement (please find the relevant links in the footer below), your use of the LinkedIn programmatic web APIs, software and other functionality and their associated tools and documentation that LinkedIn makes available to developers are governed by the LinkedIn API Terms of Use unless you have executed a separate signed partnership agreement, in which case that agreement shall apply.