Create action type

Endpoint

POST https://embedworkflow.com/api/v1/action_types

Request Body

name string, required

Name of resource

description string, optional

Description of action type

type string, required

Type of action

on boolean, optionaldefault: true

Enable or disable the resource.

params_draft string, optional

HTTP parameters as key:value pairs, one per line

headers_draft string, optional

HTTP headers as key:value pairs, one per line

url_draft string, optional

HTTP url

http_method_draft string, optional

HTTP method

code_draft string, optional

JavaScript code snippt

publish boolean, optional

Whether or not you want to publish on create

form_draft array, optional

Form field configuration

response_data_schema_draft array, optional

Data schema configuration

groups array, optional

User permission groups. Only available to users with admin role.

icon_draft object, optional

Icon configuration

Response

Returns created.

Response Properties

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

Errors

422 - unprocessable entity

Response

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
{
  "id": "0198c2e9-acfd-7a12-8304-9b5bdca7bd52",
  "code": null,
  "code_draft": null,
  "created_at": "2025-08-19T11:19:10-04:00",
  "created_at_string": "Aug 19, 2025 11:19 am EDT",
  "created_at_utc": "2025-08-19T15:19:10Z",
  "description": null,
  "form": [],
  "form_draft": [],
  "groups": [],
  "has_draft": false,
  "headers": null,
  "headers_draft": null,
  "http_method": null,
  "http_method_draft": null,
  "icon": {},
  "icon_draft": {},
  "last_published_at": null,
  "last_published_at_string": null,
  "last_published_at_utc": null,
  "name": "Send Email",
  "object": "action_type",
  "on": false,
  "params": null,
  "params_draft": null,
  "primary_category": null,
  "required_app_connection": null,
  "response_data_schema": [],
  "response_data_schema_draft": [],
  "secondary_category": null,
  "source": "core",
  "type": "CustomApiRequest",
  "updated_at": "2025-08-19T11:19:10-04:00",
  "updated_at_string": "Aug 19, 2025 11:19 am EDT",
  "updated_at_utc": "2025-08-19T15:19:10Z",
  "url": null,
  "url_draft": null
}