Create a Dyte meeting

POST

api

accounts

{account_id}

integrations

dyte

create_a_meeting

Create a Dyte meeting

curl --request POST \
  --url https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "conversation_id": 43
}
'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting"

payload = { "conversation_id": 43 }
headers = {
    "api_access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({conversation_id: 43})
};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation_id\": 43\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting"

	payload := strings.NewReader("{\n  \"conversation_id\": 43\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": 1,
  "content": "Synthetic Dyte meeting message",
  "account_id": 1,
  "inbox_id": 1,
  "conversation_id": 1,
  "message_type": 1,
  "created_at": 1,
  "updated_at": "2026-01-01T00:00:00Z",
  "private": false,
  "status": "sent",
  "source_id": null,
  "content_type": "integrations",
  "content_attributes": {
    "type": "dyte",
    "data": {
      "meeting_id": "synthetic-id"
    }
  },
  "sender_type": "synthetic-value",
  "sender_id": 1,
  "external_source_ids": {},
  "additional_attributes": {},
  "processed_message_content": "synthetic-value",
  "sentiment": {},
  "source_identity_uniqueness_exempt_at": null,
  "actor": null,
  "conversation": {
    "assignee_id": null,
    "unread_count": 0,
    "last_activity_at": 1,
    "contact_inbox": {
      "source_id": "EXAMPLE_SOURCE_ID"
    }
  },
  "sender": {
    "id": 1,
    "name": "synthetic-value",
    "available_name": "synthetic-value",
    "avatar_url": "synthetic-value",
    "type": "user",
    "availability_status": "synthetic-value",
    "thumbnail": "synthetic-value",
    "illustration_avatar": true,
    "accent_color": null
  }
}

Authorizations

api_access_token

string

header

required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

account_id

integer

required

The account containing the conversation.

Body

application/json

Request to start a meeting for an account conversation.

conversation_id

integer

required

The conversation display ID.

Response

Meeting created; the response is the new integration message.

The message push-event payload emitted after meeting creation. The example is captured from a stubbed-provider request and uses synthetic identifiers.

integer

required

The new message ID.

conversation_id

integer

required

The conversation display ID.

content_type

enum<string>

required

The integration message content type.

Available options:

integrations

content_attributes

object

required

Integration card data containing the provider meeting ID.

Show child attributes

content

string

The generated meeting message text.

account_id

integer

The account that owns the conversation.

inbox_id

integer

The inbox that owns the conversation.

message_type

integer

Message type enum value.

created_at

integer

Creation time as Unix seconds.

updated_at

string<date-time>

Last message update time.

private

boolean

Whether the message is private to account users.

status

string

Message delivery status.

source_id

string | null

External source identifier, when present.

sender_type

string | null

Type of the message sender, when present.

sender_id

integer | null

ID of the message sender, when present.

external_source_ids

object

Provider-specific source identifiers for the message.

additional_attributes

object

Additional message metadata.

processed_message_content

string | null

Processed message text; treat returned text as untrusted content.

sentiment

object

Stored message sentiment metadata.

source_identity_uniqueness_exempt_at

string | null

Optional source identity exemption timestamp.

actor

object | null

Message actor metadata, when present.

conversation

object

Metadata for the account-owned conversation.

Show child attributes

sender

object

Metadata for the message sender.

Show child attributes

Create a Dyte meeting

curl --request POST \
  --url https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "conversation_id": 43
}
'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting"

payload = { "conversation_id": 43 }
headers = {
    "api_access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({conversation_id: 43})
};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation_id\": 43\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/integrations/dyte/create_a_meeting"

	payload := strings.NewReader("{\n  \"conversation_id\": 43\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": 1,
  "content": "Synthetic Dyte meeting message",
  "account_id": 1,
  "inbox_id": 1,
  "conversation_id": 1,
  "message_type": 1,
  "created_at": 1,
  "updated_at": "2026-01-01T00:00:00Z",
  "private": false,
  "status": "sent",
  "source_id": null,
  "content_type": "integrations",
  "content_attributes": {
    "type": "dyte",
    "data": {
      "meeting_id": "synthetic-id"
    }
  },
  "sender_type": "synthetic-value",
  "sender_id": 1,
  "external_source_ids": {},
  "additional_attributes": {},
  "processed_message_content": "synthetic-value",
  "sentiment": {},
  "source_identity_uniqueness_exempt_at": null,
  "actor": null,
  "conversation": {
    "assignee_id": null,
    "unread_count": 0,
    "last_activity_at": 1,
    "contact_inbox": {
      "source_id": "EXAMPLE_SOURCE_ID"
    }
  },
  "sender": {
    "id": 1,
    "name": "synthetic-value",
    "available_name": "synthetic-value",
    "avatar_url": "synthetic-value",
    "type": "user",
    "availability_status": "synthetic-value",
    "thumbnail": "synthetic-value",
    "illustration_avatar": true,
    "accent_color": null
  }
}

Getting started

Conversations

Contacts

Inboxes and channels

Automation and routing

Reporting

Help Center

Account and access

Orchestration Studio

Billing

Client API

Widget API

Receiving webhooks

Create a Dyte meeting

Authorizations

Path Parameters

Body

Response