Skip to main content
Create a Slack message

Authorizations

Authorization
string
header
required

A Tightknit admin API key, sent as Authorization: Bearer <key>.

Body

application/json
channel_id
string

The channel to post in. A private channel must have the Tightknit app in it; the app joins a public channel it cannot otherwise post to.

Pattern: ^[CG][A-Z0-9]{8,20}$
dm_slack_profile_ids
string[]

Members to also send the message to as a direct message from the app, one each. A profile's slack_profile_id.

Required array length: 1 - 50 elements
Pattern: ^[UW][A-Z0-9]{8,20}$
text
string

The message as Slack mrkdwn, sent as a single section block. Send this or blocks.

Required string length: 1 - 3000
blocks
object[]

The message as a Slack Block Kit payload, which Slack validates. Send this or text.

Required array length: 1 - 50 elements
identity
enum<string>
default:community

Who the channel message is posted as. One of:

  • community: the app under the community name and logo.
  • bot: the app itself.
Available options:
community,
bot
thread_ts
string

Post as a reply in this message's thread, in the same channel.

Pattern: ^\d{10}\.\d{6}$
publish_to_site
boolean

Also publish the channel message to the community site, when the channel's feed accepts posts.

Response

Success

object
enum<string>
required

Always slack_message.

Available options:
slack_message
channel_id
string | null
required

Slack’s id for the channel the message was posted in. null when the message went out only as direct messages.

Example:

"C01ABC123"

ts
string | null
required

The channel message's Slack timestamp. null when the message went out only as direct messages.

Example:

"1718000042.000123"

message_id
string | null
required

The community site post, when publish_to_site created one.

Example:

"msg_9f2b8c1d4e5a"

failed_dm_slack_profile_ids
string[]
required

Direct message recipients the message did not reach. The rest of the send went out, so sending again would repeat it.

Example: