Resource Aliases

You can refer to all the resources with their IDs. Alternatively, some resources can be accessed via a more human readable alias.

Syntax:
alt:ALIAS_NAME:ALIAS_VALUE

You can use an alias for the following resources:

  • Teammates can be identified with their email.
  • Channels can be identified with their address.
  • Contacts can be identified with one of their source and handle.
  • Messages can be identified with their uid.
  • Accounts can be identified with their domain or external ID.

Examples:

  • alt:email:[email protected] for the teammate with the email address [email protected].
  • alt:address:@FrontApp for the channel with the address @FrontApp.
  • alt:twitter:@leela for the contact having the twitter handle @leela.
  • alt:phone:+12345678900 for the contact having the phone number +12345678900.
  • alt:uid:3b1q41d8 for the message with the uid 3b1q41d8.
  • alt:domain:example.com for the Account with the domain example.com.
  • alt:ext_id:abc123 for the Account with the external ID abc123.