Action types API

Define custom action types that can be used in workflows

Available Endpoints

Endpoints

The Action Type Object

id string

System-generated unique identifier

code string

Code content for the action type

code_draft string

Draft code content for the action type

created_at string

Created at in specified timezone

created_at_string string

Created at formatted as human-readable string

created_at_utc string

Created at in UTC

description string

Description of the action type

groups array

Permission groups for this action type

has_draft boolean

Whether the action type has unsaved draft changes

headers string

Headers configuration for the action type

headers_draft string

Draft headers configuration for the action type

http_method string

HTTP method for the action type

http_method_draft string

Draft HTTP method for the action type

icon object

Icon configuration for the action type

icon_draft object

Draft icon configuration for the action type

last_published_at string

Last published at in specified timezone

last_published_at_string string

Last published at formatted as human-readable string

last_published_at_utc string

Last published at in UTC

name string

Name of the action type

object string

Object type identifier

on boolean

Whether the action type is enabled

params string

Parameters configuration for the action type

params_draft string

Draft parameters configuration for the action type

primary_category string

Primary category classification

required_app_connection string

The required app connection for this action type

secondary_category string

Secondary category classification

source string

Source identifier for the action type

type string

Type classification of the action

updated_at string

Updated at in specified timezone

updated_at_string string

Updated at formatted as human-readable string

updated_at_utc string

Updated at in UTC

url string

URL for the action type

url_draft string

Draft URL for the action type

form array

Form fields for the action type

form_draft array

Draft form fields for the action type

response_data_schema array

Response data schema for the action type

response_data_schema_draft array

Draft response data schema for the action type

Action Type Object
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
{
  "id": "01980228-9646-75b8-b833-5a38dc99e30a",
  "code": null,
  "code_draft": null,
  "created_at": "2025-07-13T01:01:11-04:00",
  "created_at_string": "Jul 13, 2025 01:01 am EDT",
  "created_at_utc": "2025-07-13T05:01:11Z",
  "description": "Send a message to a Slack channel",
  "form": [
    {
      "id": "field_1",
      "data": {
        "url": "https://embedworkflow.com/app/connect/options",
        "label_key": "name",
        "value_key": "id",
        "object_key": "channels",
        "parameters": {
          "types": "public_channel,private_channel",
          "exclude_archived": "true"
        },
        "target_url": "https://slack.com/api/conversations.list"
      },
      "description": "Select a channel to send the message to",
      "display_as_placeholder": false,
      "display_in_form": true,
      "label": "Channel",
      "name": "form[slack_channel]",
      "object": "field",
      "required": true,
      "type": "AsyncSelect"
    },
    {
      "id": "field_2",
      "data": {},
      "description": "The message text to send",
      "display_as_placeholder": false,
      "display_in_form": true,
      "label": "Message",
      "name": "form[slack_message_text]",
      "object": "field",
      "required": true,
      "type": "TextArea"
    },
    {
      "id": "field_3",
      "data": {},
      "description": "JSON array of Slack blocks for rich formatting (optional)",
      "display_as_placeholder": false,
      "display_in_form": true,
      "label": "Blocks JSON",
      "name": "form[slack_blocks]",
      "object": "field",
      "required": false,
      "type": "TextArea"
    }
  ],
  "form_draft": [],
  "groups": [],
  "has_draft": true,
  "headers": "Content-Type:application/json\nAuthorization:Bearer {{app_connection.bot_token}}",
  "headers_draft": null,
  "http_method": "post",
  "http_method_draft": null,
  "icon": {
    "url": "https://s3.us-east-1.amazonaws.com/cdn.ewf.to/apps/slack.svg"
  },
  "icon_draft": {},
  "last_published_at": null,
  "last_published_at_string": null,
  "last_published_at_utc": null,
  "name": "Send Message",
  "object": "action_type",
  "on": true,
  "params": "channel:{{form[slack_channel]}}\ntext:{{form[slack_message_text]}}\nblocks:{{form[slack_blocks]}}",
  "params_draft": null,
  "primary_category": "communication",
  "required_app_connection": "slack",
  "response_data_schema": [
    {
      "variable": "message_id",
      "data_path": "ts",
      "display_label": null,
      "format": null,
      "groups": null,
      "list_values_variable": null,
      "object": "data_type",
      "required": true,
      "source": "action_response",
      "type": "String",
      "value": null
    },
    {
      "variable": "channel_id",
      "data_path": "channel",
      "display_label": null,
      "format": null,
      "groups": null,
      "list_values_variable": null,
      "object": "data_type",
      "required": true,
      "source": "action_response",
      "type": "String",
      "value": null
    },
    {
      "variable": "message_text",
      "data_path": "message['text']",
      "display_label": null,
      "format": null,
      "groups": null,
      "list_values_variable": null,
      "object": "data_type",
      "required": true,
      "source": "action_response",
      "type": "String",
      "value": null
    },
    {
      "variable": "timestamp",
      "data_path": "ts",
      "display_label": null,
      "format": null,
      "groups": null,
      "list_values_variable": null,
      "object": "data_type",
      "required": true,
      "source": "action_response",
      "type": "Date",
      "value": null
    },
    {
      "variable": "is_successful",
      "data_path": "ok",
      "display_label": null,
      "format": null,
      "groups": null,
      "list_values_variable": null,
      "object": "data_type",
      "required": true,
      "source": "action_response",
      "type": "Boolean",
      "value": null
    }
  ],
  "response_data_schema_draft": [],
  "secondary_category": "productivity",
  "source": "Apps",
  "type": "CustomApiRequest",
  "updated_at": "2025-07-13T01:01:11-04:00",
  "updated_at_string": "Jul 13, 2025 01:01 am EDT",
  "updated_at_utc": "2025-07-13T05:01:11Z",
  "url": "https://slack.com/api/chat.postMessage",
  "url_draft": null
}
←Retry action
List action types→