Organizations and Brands Overview

Warning

Deprecation Notice
The Marketing Version 202311 (Marketing November 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 Access Control
• Organizations Lookup API and Fields
• Organization Authorizations

Organization Statistics and Analytics

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

• Retrieve Follower Statistics
• Retrieve Share Statistics
• Retrieve Page Statistics

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.