Teamly API
  1. Webhooks
Teamly API
  • Introduction
  • Getting Started
    • Quick Start
    • API Versions
  • Permissions
    • Channel Permission Values
    • Team Global Permissions
  • Core Resources
    • Channels
      • Update Channel
        • Update Team Channel
        • Update Channel Role Permissions
      • Get Team Channels
      • Create Team Channel
      • Delete Team Channel
      • Duplicate a Channel on Team
      • Update Channel Priorities of Team
    • Messages
      • Create Channel Message
      • Delete a Channel Message
      • Get Channel Messages
      • Update a Channel Message
      • React to Message
      • Delete Reaction from Message
      • Get a Channel Message by Id
    • Teams
      • Members
        • Add Role to Member
        • Remove Role from Member
        • Kick Member from Team
        • Get Member
      • Bans
        • Get Banned Users
        • Unban User
        • Ban User
      • Get a Team
      • Update a Team
    • Roles
      • Create a Role for Team
      • Get Team Roles
      • Delete a Role
      • Clone Role
      • Update Role Priorities of Team
      • Update a Team Role
    • Users
      • Get User By Id
      • Get Logged In User
    • Todos
      • Get Todo Items
      • Create Todo Item
      • Delete Todo Item
      • Clone Todo Item
      • Update Todo Item
    • Direct Messages
      • Create a Direct Message
    • Applications
      • Get Application Submissions
      • Update a Application Status
      • Update Team's Application Status
      • Update Team's Application Questions
      • Get Application By Id
    • Reactions
      • Get Team's Custom Reactions
      • Create New Custom Reaction for Team
      • Update a Custom Reaction
      • Delete a Custom Reaction
    • Attachments
      • Upload Attachment
    • Voice
      • Get Credentials for Join Voice Channel
      • Update Your Voice Metadata
      • Leave from Voice Channel
    • Webhooks
      • Create Message With Webhook
        POST
      • Webhook for GitHub
        POST
    • Blog
      • Get Blog Posts
      • Create a Blog Post
      • Delete a Blog Post
    • Category
      • Create a Category
      • Update a Category
      • Update Category Role Permissions
      • Delete a Category
      • Add a Channel To Category
      • Delete a channel from category
      • Set channel priority of category
      • Set a team's category priority
  • Schemas
    • Message
    • Message Embed
    • Channel
    • Direct Message
    • To-do Item
    • Application
    • Emoji
    • Team
    • User
    • Role
    • Webhook
    • Blog
    • Category
  • Websockets
    • Example Bot
    • WebSocket event envelope
      • WebSocket event envelope
      • Keepalive
      • Welcome Message
      • Gateway Opcodes
      • Gateway Close Event Codes
    • Websocket events
      • CHANNEL_CREATED
      • CHANNEL_DELETED
      • CHANNEL_UPDATED
      • MESSAGE_SEND
      • MESSAGE_UPDATED
      • MESSAGE_DELETED
      • MESSAGE_REACTION_ADDED
      • MESSAGE_REACTION_REMOVED
      • PRESENCE_UPDATE
      • TEAM_ROLE_CREATED
      • TEAM_ROLE_DELETED
      • TEAM_ROLES_UPDATED
      • TEAM_UPDATED
      • TODO_ITEM_CREATED
      • TODO_ITEM_DELETED
      • TODO_ITEM_UPDATED
      • USER_JOINED_TEAM
      • USER_LEFT_TEAM
      • USER_JOINED_VOICE_CHANNEL
      • USER_LEFT_VOICE_CHANNEL
      • USER_PROFILE_UPDATED
      • USER_ROLE_ADDED
      • USER_ROLE_REMOVED
      • USER_UPDATED_VOICE_METADATA
      • BLOG_CREATED
      • BLOG_DELETED
      • CATEGORIES_PRIORITY_UPDATED
      • CATEGORY_UPDATED
      • CATEGORY_DELETED
      • CATEGORY_CREATED
      • CHANNELS_PRIORITY_UPDATED
    • Connecting via WebSocket
  1. Webhooks

Create Message With Webhook

Developing
POST
https://api.teamly.one/api/v1/webhooks/{webhookId}/{webhookToken}

Request

Path Params
webhookId
string 
required
webhookToken
string 
required
Header Params
Content-Type
string 
required
Default:
application/json
Body Params application/json
username
string 
required
Override the default username of the webhook
content
string  | null 
optional
Content of the message (Markdown supported)
<= 2000 characters
embeds
array[object (Message Embed) {8}] 
optional
List of embeds included with the message
<= 5 items
title
string  | null 
required
Title of the embed
<= 16 characters
description
string  | null 
required
Description text for the embed (Markdown supported)
<= 1024 characters
url
string <uri> | null 
optional
URL associated with the embed
color
number  | null 
required
Color code for the embed, represented in hexadecimal format
author
object  | null 
required
Contains information about the author of the embed
thumbnail
object  | null 
required
Contains information about the thumbnail image
image
object  | null 
required
Contains information about the image
footer
object  | null 
required
Contains information about the footer
Example
{
  "username": "string",
  "content": "string",
  "embeds": [
    {
      "title": "string",
      "description": "string",
      "url": "http://example.com",
      "color": 0,
      "author": {
        "name": "string",
        "icon_url": "http://example.com"
      },
      "thumbnail": {
        "url": "http://example.com"
      },
      "image": {
        "url": "http://example.com"
      },
      "footer": {
        "text": "string",
        "icon_url": "http://example.com"
      }
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.teamly.one/api/v1/webhooks//' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "string",
    "content": "string",
    "embeds": [
        {
            "title": "string",
            "description": "string",
            "url": "http://example.com",
            "color": 0,
            "author": {
                "name": "string",
                "icon_url": "http://example.com"
            },
            "thumbnail": {
                "url": "http://example.com"
            },
            "image": {
                "url": "http://example.com"
            },
            "footer": {
                "text": "string",
                "icon_url": "http://example.com"
            }
        }
    ]
}'

Responses

🟢200Success
application/json
Body
success
boolean 
required
message
object (Message) 
required
id
string 
required
Unique identifier for the message
channelId
string 
required
ID of the channel where the message was posted
type
string 
required
Type of the message (e.g., 'text' for a text message)
content
string  | null 
required
Content of the message (Markdown supported)
<= 2000 characters
attachments
array [object]  | null 
optional
Attachments for the message (may be empty)
<= 5 items
createdBy
object (User) 
required
User who created the message
editedAt
string <date-time>
optional
Timestamp of when the message was last edited
replyTo
string 
optional
ID of the message being replied to, or null if the message is not a reply
embeds
array[object (Message Embed) {8}] 
required
List of embeds included with the message
<= 5 items
emojis
array [object {1}] 
optional
reactions
array [object {3}] 
optional
nonce
string 
optional
Unique identifier for this message instance, used to prevent duplicates
createdAt
string <date-time>
required
Timestamp of when the message was created
mentions
object 
required
Information about users mentioned in the message
Example
{
  "success": true,
  "message": {
    "id": "string",
    "channelId": "string",
    "type": "string",
    "content": "string",
    "attachments": [
      {}
    ],
    "createdBy": {
      "id": "string",
      "username": "string",
      "subdomain": "string",
      "profilePicture": null,
      "banner": null,
      "bot": false,
      "presence": 0,
      "badges": [],
      "userStatus": {
        "content": null,
        "emojiId": null
      },
      "userRPC": {
        "type": null,
        "name": null,
        "id": null,
        "startedAt": null
      },
      "connections": [],
      "createdAt": "CURRENT_TIMESTAMP",
      "lastOnline": "CURRENT_TIMESTAMP",
      "system": false
    },
    "editedAt": "2019-08-24T14:15:22Z",
    "replyTo": "string",
    "embeds": [
      {
        "title": "string",
        "description": "string",
        "url": "http://example.com",
        "color": 0,
        "author": {
          "name": "string",
          "icon_url": "http://example.com"
        },
        "thumbnail": {
          "url": "http://example.com"
        },
        "image": {
          "url": "http://example.com"
        },
        "footer": {
          "text": "string",
          "icon_url": "http://example.com"
        }
      }
    ],
    "emojis": [
      {
        "emojiId": "string"
      }
    ],
    "reactions": [
      {
        "emojiId": "string",
        "count": 0,
        "users": [
          {
            "userId": "string",
            "timestamp": "2019-08-24T14:15:22Z"
          }
        ]
      }
    ],
    "nonce": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "mentions": {
      "users": [
        "string"
      ]
    }
  }
}
Previous
Leave from Voice Channel
Next
Webhook for GitHub
Built with