Skip to main content

app.bsky.contact.importContacts

#main​

Import contacts for securely matching with other users. This follows the protocol explained in https://docs.bsky.app/blog/contact-import-rfc. Requires authentication.

Input​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
tokenstring-✅JWT to authenticate the call. Use the JWT received as a response to the call to app.bsky.contact.verifyPhone.
contactsarray of string-✅List of phone numbers in global E.164 format (e.g., '+12125550123'). Phone numbers that cannot be normalized into a valid phone number will be discarded. Should not repeat the 'phone' input used in app.bsky.contact.verifyPhone.

Output​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
matchesAndContactIndexesarray of app.bsky.contact.defs#matchAndContactIndex-✅The users that matched during import and their indexes on the input contacts, so the client can correlate with its local list.