Profile Edit API - Organizations

  • Article

This sub-resource API will allow you to create, update, and delete organizations of a member. See Organization Fields for a description of the fields available within this object.

Supported Methods

CREATE | PARTIAL_UPDATE | DELETE

CREATE

POST https://api.linkedin.com/v2/people/id={person ID}/organizations

sample request body

{
    "description": {
        "localized": {
            "en_US": {
                "rawText": "Founder"
            }
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "name": {
        "localized": {
            "en_US": "Super Organization"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "occupation": "urn:li:position:(urn:li:person:123ABC,677616236)",
    "position": {
        "localized": {
            "en_US": "Developer"
        },
        "preferredLocale": {
            "country": "US",
            "language": "en"
        }
    },
    "startMonthYear": {
        "month": 1,
        "year": 2014
    }
}

Note

A successful response will return a 201 Created HTTP status code. To record the created entity's id, refer to the header x-linkedin-id field.

PARTIAL UPDATE

POST https://api.linkedin.com/v2/people/id={person ID}/organizations/{organization ID}

sample request body

{
    "patch": {
        "$set": {
            "name": {
                "localized": {
                    "en_US": "LinkedIn Social Club - Mountain View"
                },
                "preferredLocale": {
                    "country": "US",
                    "language": "en"
                }
            },
            "startMonthYear": {
                "month": 3,
                "year": 2013
            }
        }
    }
}

Sample Json to delete one or more fields. If you attempt to delete a field that is mandatory, the API will return a 422 Error Response. See Organization Fields for allowed list of fields for this resource

sample request body

{
    "patch": {
        "$delete": [
            "field1",
            "field2"
        ]
    }
}

DELETE

DELETE https://api.linkedin.com/v2/people/id={person ID}/organizations/{organization ID}