LinkedIn
Instagram
Join Slack Community
Auth On Behalf
User Authentication for Your Integration
Execute actions as the actual user, not as a bot. Messages, emails, and invites sent from real accounts, indistinguishable from manual actions.
UNIPILE
Hosted Auth
Refresh Token
Webhooks
What is Auth on Behalf?
With Auth on Behalf, users explicitly grant your application permission to act on their connected accounts. Through a secure redirect flow, they authenticate directly with the provider, your app never touches their credentials. Once authorized, you receive a simple account_id to execute any action within their granted scope.
User Identity Mapping
Link your internal user IDs to authenticated provider accounts
Redirect-Based Consent
Users authorize access through provider's native consent flow
Token Abstraction
Unipile manages authorization tokens, you only use a simple account_id
API Execution on Behalf
All API calls are executed in the context of the authenticated user
Authentication Lifecycle
1
Generate Auth Link
Your backend requests a hosted auth URL from Unipile API
2
User Consent
User is redirected to provider's authorization screen
Secure Redirect
3
Session Established
Provider session created and tokens securely stored
4
Callback Received
Your notify_url receives account_id and user mapping
Webhook Ready
5
Execute API Calls
Make requests on behalf of the user using account_id