Platforms

LinkedIn

LinkedIn over the overads API: status, connection, limits, media rules and platformSettings keys.

Status: Live. Posts created over the API deliver to this channel today.

Publishes today, as the signed-in member or as a Company Page the member administers.

Connecting#

OAuth through LinkedIn, in the app, which connects the member profile. Company Pages are a second step: the app reads live from LinkedIn which Pages the member may post as and adds the ones chosen as separate connections, each with its own id for connectionIds, named after the Page. A Page posts with the member's token, so adding one needs no second consent, and a role revoked on LinkedIn drops the Page from the picker without anyone reconnecting. Company Page posting is a deployment switch on the overads side; where it is off the picker answers 503.

Once connected the account appears in GET /connections with platform: "linkedin". Use its id in connectionIds.

Limits#

• Up to 9 images, JPEG or PNG.
• Video, GIF and WebP are not supported on LinkedIn yet: a post that carries one fails when it is sent.
• Media is optional.

Limits are checked when the post is created or edited, so an over-limit post is refused then with a sentence naming the cap, not at the scheduled minute. These refusals answer 400 with the flat body { statusCode, code, message }, not the { error } envelope: TOO_LONG, TOO_MANY_ITEMS, MEDIA_UNSUPPORTED, MEDIA_REQUIRED, MEDIA_TOO_LARGE (over the channel's video size cap), MEDIA_TOO_LONG (over its duration cap). The full list is under Channel-limit refusals.

Settings#

Pass these under platformSettings.linkedin. Every key is optional. An unknown key is refused with PLATFORM_SETTING_UNKNOWN and the dotted path of the key.

{ "linkedin": { "visibility": "PUBLIC" } }