Actions67
- ApiKeys Actions
- Auth Actions
- Billing Actions
- Chats Actions
- Identities Actions
- Members Actions
- Messages Actions
- Platform Logs Actions
- Platforms Actions
- Projects Actions
- Webhooks Actions
Identities → Lookup
AI-generatedSummary
Looks up an identity by platform configuration ID and provider-specific user ID. Returns the matching identity or null if not found.
Inputs
- platformId (required) — Platform configuration ID used as a query parameter to scope the lookup to a specific platform integration.
- providerUserId (required) — Provider-specific user ID used as a query parameter to identify the user on that platform.
- project (required) — Project identifier to operate on. Defaults to 'default' if not specified. Used as a path segment in the API request.
Output shape
Identity object or null
Returns the identity record if a match is found; returns null if no identity matches the provided platform ID and user ID combination.
Examples
Example 1: Retrieve an identity for a Telegram user
Set platformId to 'telegram', providerUserId to the user's chat ID, and project to your n8n project ID.