Organization Access Control

A role defines the privileges that a member has within the organization. You must be an authenticated member with role type ADMINISTRATOR for an organization to use many of the Organization APIs.

You can search for access control information by member or organizational entity URNs.

Organization Roles

Role Type Description
ADMINISTRATOR Access to administer an organizational entity. An administrator can post updates, edit the organization's page, add other admins, view analytics, and view notifications.
DIRECT_SPONSORED_CONTENT_POSTER Access to read and create direct sponsored content for an organizational entity.
RECRUITING_POSTER Access to post to an organizational entity.
LEAD_CAPTURE_ADMINISTRATOR Access to view and manage landing pages for the company, as well as create new landing pages or edit existing ones.
LEAD_GEN_FORMS_MANAGER Access to retrieve leads that belong to a specific account which is associated with a company page.

Find Access Control Information

You must be an ADMINSTRATOR to perform many of these requests.

Find a Member's Organization Access Control Information

Sample Request

GET https://api.linkedin.com/v2/organizationalEntityAcls?q=roleAssignee

Parameters

Field Description Format Required
role Limit results to specific roles, such as ADMINISTRATOR. string No
state Limit results to specific role states, such as APPROVED. string No

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "state": "APPROVED",
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:R8302pZx",
      "organizationalTarget": "urn:li:organization:1000"
    }
  ]
}

Find Organization Administrators

Find all members who have elevated access for a given organizational entity using either an organization URN or organizationBrand URN.

Sample Request

GET https://api.linkedin.com/v2/organizationalEntityAcls?q=organizationalTarget&organizationalTarget={organization URN}&role=ADMINISTRATOR&state=APPROVED

Find an Organization's Access Control Information

Find all members who are in specific roles for a given organizational entity using an organization URN or organizationBrand URN.

Sample Request

GET https://api.linkedin.com/v2/organizationalEntityAcls?q=organizationalTarget&organizationalTarget={URN}

Parameters

Field Description Format Required
organizationalTarget The organizational entity for which access control information is retrieved. Must either be in the format urn:li:organization:{id} or urn:li:organizationBrand:{id} URN Yes
role Limit results to specific roles, such as ADMINISTRATOR. string No
state Limit results to specific role states such as APPROVED. string No

Sample Response

{
  "paging": {
    "count": 10,
    "start": 0
  },
  "elements": [
    {
      "state": "APPROVED",
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:A839rocZ",
      "organizationalTarget": "urn:li:organization:1000"
    },
    {
      "state": "APPROVED",
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:pwo82E2v",
      "organizationalTarget": "urn:li:organization:1000"
    },
    {
      "state": "APPROVED",
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:vQpe2J8",
      "organizationalTarget": "urn:li:organization:1000"
    },
    {
      "state": "APPROVED",
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:J2foLx4",
      "organizationalTarget": "urn:li:organization:1000"
    }
  ]
}

Using Projections

Use projections to get more information, such as the member's first and last name or the organization name. See here for more information on how projections work.

Sample Request

GET https://api.linkedin.com/v2/organizationalEntityAcls?q=roleAssignee&role=ADMINISTRATOR&projection=(elements*(*,roleAssignee~(localizedFirstName, localizedLastName), organizationalTarget~(localizedName)))

Sample Response

{
  "elements": [
    {
      "organizationalTarget~": {
        "localizedName": "TestCompany"
      },
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:pE3vIq7yK6",
      "state": "APPROVED",
      "roleAssignee~": {
        "localizedLastName": "Smith",
        "localizedFirstName": "John"
      },
      "organizationalTarget": "urn:li:organization:18062654"
    }
    {
      "organizationalTarget~": {
        "localizedName": "TestCompanyShowcase"
      },
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:pE3vIq7yK6",
      "state": "APPROVED",
      "roleAssignee~": {
        "localizedLastName": "Smith",
        "localizedFirstName": "John"
      },
      "organizationalTarget": "urn:li:organizationBrand:18085185"
    },
    {
      "organizationalTarget~": {
        "localizedName": "DevTestCo \"Quote\""
      },
      "role": "ADMINISTRATOR",
      "roleAssignee": "urn:li:person:pE3vIq7yK6",
      "state": "APPROVED",
      "roleAssignee~": {
        "localizedLastName": "Smith",
        "localizedFirstName": "John"
      },
      "organizationalTarget": "urn:li:organization:2414183"
    }
  ]
}