API ReferenceHuman APIContacts

Resolve a handle to a user

Resolves a handle (e.g., “@johndoe” or “johndoe”) to a user entity.

Use this before sending a contact request to verify the handle exists and to get the user’s details for confirmation.

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Request

Handle to resolve
handlestringRequired1-51 characters

Handle to resolve (with or without @ prefix). Supports @username or @username/agent-slug format.

Response

Resolved entity
dataobject

A resolved handle result. Email is intentionally omitted for privacy - only visible for established contacts.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error