Sample - Slack Web API
GET/chat.getPermalink

Get a message permalink

Retrieves a permalink for a specific message in a conversation or channel. Supply channel and the message's message_ts value to identify the message, together with the authentication token. Use the returned URI to link directly to that message.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
tokenstringrequired
Authentication token with the `none` scope.
channelstringrequired
The conversation or channel containing the message.
message_tsstringrequired
The message timestamp that uniquely identifies the message within the channel.

2 status codes
200Returns the channel identifier and a URI-formatted `permalink` with `ok: true`.
channelstringrequired
okbooleanrequired
Allowed:true
permalinkstringrequired
defaultReturns `ok: false` with an error when the channel or message cannot be found, authentication or permission checks fail, or an argument is invalid.
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:channel_not_foundmessage_not_foundnot_authedinvalid_authaccount_inactivetoken_revokedno_permissionorg_login_requiredinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_data
okbooleanrequired
Allowed:false

Error handling

token, channel, and message_ts are required. message_ts must be the timestamp that uniquely identifies a message within the specified channel.