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 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.