Keepface
Sign up

1-click LinkedIn / X share with UTM injection

Employees connect their LinkedIn / X once, then 1-click shares from the library post to their personal feed with UTMs auto-injected. Every share emits a leaderboard event.

Friction-free share is what makes EA actually work. Here’s the mechanics.

Employee setup (once)

At /user/connections, employees connect:

  • LinkedIn via OAuth (Sign In with LinkedIn + w_member_social scopes)
  • X (Twitter) via OAuth 2.0 PKCE

After connection, share buttons light up across the post library.

Sharing flow

  1. Employee picks a post in the library, clicks Share to LinkedIn
  2. Keepface calls the platform API server-side with the employee’s token
  3. UTMs are auto-injected into the target_url
  4. Share URL comes back; we record a share event in the leaderboard table (idempotent on (employee_id, post_id, platform))
  5. Employee sees a “Shared! View on LinkedIn” confirmation

What gets posted

The post body verbatim, plus:

  • Optional personal lead-in if the employee added one
  • The CTA URL with UTMs
  • Media attached (image / video)

Failure handling

Token expiry triggers a re-auth prompt. Platform-side errors (e.g. LinkedIn rate limit) surface a clear message, the leaderboard event is not recorded for failed shares.

Was this article helpful?