List all campaigns
Every campaign in the account, ongoing and one-off. Each entry embeds the full inbox it sends from.
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/campaigns \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/campaigns"
headers = {"api_access_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};
fetch('https://app.tied.com/api/v1/accounts/{account_id}/campaigns', 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}/campaigns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tied.com/api/v1/accounts/{account_id}/campaigns"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": 1,
"title": "Pricing page onboarding help",
"description": null,
"account_id": 1,
"inbox": {
"id": 4,
"avatar_url": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/tied-app-icon.png",
"channel_id": 1,
"name": "Webchat",
"channel_type": "Channel::WebWidget",
"greeting_enabled": false,
"greeting_message": null,
"working_hours_enabled": false,
"enable_email_collect": true,
"csat_survey_enabled": false,
"csat_config": {},
"enable_auto_assignment": true,
"auto_assignment_config": {},
"out_of_office_message": null,
"working_hours": [
{
"day_of_week": 0,
"closed_all_day": true,
"open_hour": null,
"open_minutes": null,
"close_hour": null,
"close_minutes": null,
"open_all_day": false
},
{
"day_of_week": 1,
"closed_all_day": false,
"open_hour": 9,
"open_minutes": 0,
"close_hour": 17,
"close_minutes": 0,
"open_all_day": false
}
],
"timezone": "UTC",
"callback_webhook_url": null,
"allow_messages_after_resolved": true,
"lock_to_single_conversation": false,
"sender_name_type": "friendly",
"business_name": null,
"allowed_domains": "",
"widget_color": "#FF073B",
"website_url": "https://tied.com",
"hmac_mandatory": false,
"welcome_title": null,
"welcome_tagline": null,
"web_widget_script": "\n <script>\n (function(d,t) {\n var BASE_URL=\"https://app.tied.com\";\n var g=d.createElement(t),s=d.getElementsByTagName(t)[0];\n g.src=BASE_URL+\"/packs/js/sdk.js\";\n g.async = true;\n s.parentNode.inse…",
"website_token": "EXAMPLE_WEBSITE_TOKEN",
"selected_feature_flags": [
"attachments",
"emoji_picker"
],
"reply_time": "in_a_few_minutes",
"hmac_token": "EXAMPLE_HMAC_TOKEN",
"pre_chat_form_enabled": false,
"pre_chat_form_options": {
"pre_chat_fields": [
{
"name": "emailAddress",
"type": "email",
"label": "Email Id",
"enabled": false,
"required": true,
"field_type": "standard"
},
{
"name": "fullName",
"type": "text",
"label": "Full name",
"enabled": false,
"required": false,
"field_type": "standard"
}
],
"pre_chat_message": "Share your queries or comments here."
},
"continuity_via_email": true,
"messaging_service_sid": null,
"phone_number": null,
"provider": null
},
"message": "Comparing plans or seats? Ask here and we will help you land on the right one before you buy.",
"template_params": null,
"campaign_status": "active",
"enabled": true,
"campaign_type": "ongoing",
"trigger_rules": {
"url": "https://tied.com/pricing"
},
"trigger_only_during_business_hours": false,
"created_at": "2026-09-19T20:56:44.947Z",
"updated_at": "2026-09-19T20:56:44.947Z"
},
{
"id": 3,
"title": "Apple Messages rich features are live on your account",
"description": null,
"account_id": 1,
"inbox": {
"id": 3,
"avatar_url": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/tied-app-icon.png",
"channel_id": 1,
"name": "WhatsApp",
"channel_type": "Channel::Whatsapp",
"greeting_enabled": false,
"greeting_message": null,
"working_hours_enabled": false,
"enable_email_collect": true,
"csat_survey_enabled": false,
"csat_config": {},
"enable_auto_assignment": true,
"auto_assignment_config": {},
"out_of_office_message": null,
"working_hours": [
{
"day_of_week": 0,
"closed_all_day": true,
"open_hour": null,
"open_minutes": null,
"close_hour": null,
"close_minutes": null,
"open_all_day": false
},
{
"day_of_week": 1,
"closed_all_day": false,
"open_hour": 9,
"open_minutes": 0,
"close_hour": 17,
"close_minutes": 0,
"open_all_day": false
}
],
"timezone": "UTC",
"callback_webhook_url": "https://app.tied.com/webhooks/whatsapp/+15552689012",
"allow_messages_after_resolved": true,
"lock_to_single_conversation": false,
"sender_name_type": "friendly",
"business_name": null,
"allowed_domains": null,
"widget_color": null,
"website_url": null,
"hmac_mandatory": null,
"welcome_title": null,
"welcome_tagline": null,
"web_widget_script": null,
"website_token": null,
"selected_feature_flags": null,
"reply_time": null,
"messaging_service_sid": null,
"phone_number": "+15552689012",
"provider": "whatsapp_cloud",
"message_templates": {},
"provider_config": {
"api_key": "demo-local",
"phone_number_id": "demo-12",
"business_account_id": "demo-biz-12",
"webhook_verify_token": "EXAMPLE"
},
"reauthorization_required": false
},
"message": "Your Apple Messages inbox now supports list pickers, forms, time pickers and Apple Pay -- reply here and we will walk you through the first one.",
"template_params": null,
"campaign_status": "active",
"enabled": true,
"campaign_type": "one_off",
"scheduled_at": 1789851673,
"audience": [],
"trigger_rules": {},
"trigger_only_during_business_hours": false,
"created_at": "2026-09-19T21:01:13.548Z",
"updated_at": "2026-09-19T21:01:13.548Z"
}
]{
"error": "Resource could not be found"
}Authorizations
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
The numeric ID of the account
Response
Success
The campaign's display_id. This is the value the campaign endpoints take in the path.
Internal name for the campaign.
Internal description. Not shown to contacts.
The account the campaign belongs to.
Show child attributes
Show child attributes
The message body sent to the contact.
WhatsApp template parameters, for campaigns on a WhatsApp inbox that send an approved template.
A one-off campaign becomes completed once it has been sent. A completed campaign cannot be updated.
active, completed Whether the campaign is live. An ongoing campaign with enabled: false stops triggering.
Derived from the inbox, never from the request. A website inbox always produces ongoing; an SMS, Twilio SMS or WhatsApp inbox always produces one_off.
ongoing, one_off Conditions for an ongoing campaign. url is the page the visitor must be on, and time_on_page the seconds to wait before sending.
Whether to suppress the campaign outside the inbox's configured business hours.
When a one-off campaign is due to send. Always null on an ongoing campaign — it is cleared on save.
ISO-8601 timestamp of creation.
ISO-8601 timestamp of the last update.
Was this page helpful?
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/campaigns \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/campaigns"
headers = {"api_access_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};
fetch('https://app.tied.com/api/v1/accounts/{account_id}/campaigns', 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}/campaigns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tied.com/api/v1/accounts/{account_id}/campaigns"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": 1,
"title": "Pricing page onboarding help",
"description": null,
"account_id": 1,
"inbox": {
"id": 4,
"avatar_url": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/tied-app-icon.png",
"channel_id": 1,
"name": "Webchat",
"channel_type": "Channel::WebWidget",
"greeting_enabled": false,
"greeting_message": null,
"working_hours_enabled": false,
"enable_email_collect": true,
"csat_survey_enabled": false,
"csat_config": {},
"enable_auto_assignment": true,
"auto_assignment_config": {},
"out_of_office_message": null,
"working_hours": [
{
"day_of_week": 0,
"closed_all_day": true,
"open_hour": null,
"open_minutes": null,
"close_hour": null,
"close_minutes": null,
"open_all_day": false
},
{
"day_of_week": 1,
"closed_all_day": false,
"open_hour": 9,
"open_minutes": 0,
"close_hour": 17,
"close_minutes": 0,
"open_all_day": false
}
],
"timezone": "UTC",
"callback_webhook_url": null,
"allow_messages_after_resolved": true,
"lock_to_single_conversation": false,
"sender_name_type": "friendly",
"business_name": null,
"allowed_domains": "",
"widget_color": "#FF073B",
"website_url": "https://tied.com",
"hmac_mandatory": false,
"welcome_title": null,
"welcome_tagline": null,
"web_widget_script": "\n <script>\n (function(d,t) {\n var BASE_URL=\"https://app.tied.com\";\n var g=d.createElement(t),s=d.getElementsByTagName(t)[0];\n g.src=BASE_URL+\"/packs/js/sdk.js\";\n g.async = true;\n s.parentNode.inse…",
"website_token": "EXAMPLE_WEBSITE_TOKEN",
"selected_feature_flags": [
"attachments",
"emoji_picker"
],
"reply_time": "in_a_few_minutes",
"hmac_token": "EXAMPLE_HMAC_TOKEN",
"pre_chat_form_enabled": false,
"pre_chat_form_options": {
"pre_chat_fields": [
{
"name": "emailAddress",
"type": "email",
"label": "Email Id",
"enabled": false,
"required": true,
"field_type": "standard"
},
{
"name": "fullName",
"type": "text",
"label": "Full name",
"enabled": false,
"required": false,
"field_type": "standard"
}
],
"pre_chat_message": "Share your queries or comments here."
},
"continuity_via_email": true,
"messaging_service_sid": null,
"phone_number": null,
"provider": null
},
"message": "Comparing plans or seats? Ask here and we will help you land on the right one before you buy.",
"template_params": null,
"campaign_status": "active",
"enabled": true,
"campaign_type": "ongoing",
"trigger_rules": {
"url": "https://tied.com/pricing"
},
"trigger_only_during_business_hours": false,
"created_at": "2026-09-19T20:56:44.947Z",
"updated_at": "2026-09-19T20:56:44.947Z"
},
{
"id": 3,
"title": "Apple Messages rich features are live on your account",
"description": null,
"account_id": 1,
"inbox": {
"id": 3,
"avatar_url": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/tied-app-icon.png",
"channel_id": 1,
"name": "WhatsApp",
"channel_type": "Channel::Whatsapp",
"greeting_enabled": false,
"greeting_message": null,
"working_hours_enabled": false,
"enable_email_collect": true,
"csat_survey_enabled": false,
"csat_config": {},
"enable_auto_assignment": true,
"auto_assignment_config": {},
"out_of_office_message": null,
"working_hours": [
{
"day_of_week": 0,
"closed_all_day": true,
"open_hour": null,
"open_minutes": null,
"close_hour": null,
"close_minutes": null,
"open_all_day": false
},
{
"day_of_week": 1,
"closed_all_day": false,
"open_hour": 9,
"open_minutes": 0,
"close_hour": 17,
"close_minutes": 0,
"open_all_day": false
}
],
"timezone": "UTC",
"callback_webhook_url": "https://app.tied.com/webhooks/whatsapp/+15552689012",
"allow_messages_after_resolved": true,
"lock_to_single_conversation": false,
"sender_name_type": "friendly",
"business_name": null,
"allowed_domains": null,
"widget_color": null,
"website_url": null,
"hmac_mandatory": null,
"welcome_title": null,
"welcome_tagline": null,
"web_widget_script": null,
"website_token": null,
"selected_feature_flags": null,
"reply_time": null,
"messaging_service_sid": null,
"phone_number": "+15552689012",
"provider": "whatsapp_cloud",
"message_templates": {},
"provider_config": {
"api_key": "demo-local",
"phone_number_id": "demo-12",
"business_account_id": "demo-biz-12",
"webhook_verify_token": "EXAMPLE"
},
"reauthorization_required": false
},
"message": "Your Apple Messages inbox now supports list pickers, forms, time pickers and Apple Pay -- reply here and we will walk you through the first one.",
"template_params": null,
"campaign_status": "active",
"enabled": true,
"campaign_type": "one_off",
"scheduled_at": 1789851673,
"audience": [],
"trigger_rules": {},
"trigger_only_during_business_hours": false,
"created_at": "2026-09-19T21:01:13.548Z",
"updated_at": "2026-09-19T21:01:13.548Z"
}
]{
"error": "Resource could not be found"
}