create-action

curl --request POST \
  --url https://api.getmembrane.com/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "config": {},
  "key": "<string>",
  "description": "<string>",
  "inputSchema": {},
  "connectionId": "<string>",
  "integrationId": "<string>"
}
'

import requests

url = "https://api.getmembrane.com/actions"

payload = {
    "name": "<string>",
    "type": "<string>",
    "config": {},
    "key": "<string>",
    "description": "<string>",
    "inputSchema": {},
    "connectionId": "<string>",
    "integrationId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    config: {},
    key: '<string>',
    description: '<string>',
    inputSchema: {},
    connectionId: '<string>',
    integrationId: '<string>'
  })
};

fetch('https://api.getmembrane.com/actions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getmembrane.com/actions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'config' => [
        
    ],
    'key' => '<string>',
    'description' => '<string>',
    'inputSchema' => [
        
    ],
    'connectionId' => '<string>',
    'integrationId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.getmembrane.com/actions"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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))

}

HttpResponse<String> response = Unirest.post("https://api.getmembrane.com/actions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getmembrane.com/actions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "uuid": "<string>",
  "key": "<string>",
  "description": "<string>",
  "meta": {},
  "errors": [
    {}
  ],
  "revision": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "archivedAt": "<string>",
  "isDeactivated": true,
  "isReadOnly": true,
  "integrationId": "<string>",
  "integrationUuid": "<string>",
  "integrationKey": "<string>",
  "parentId": "<string>",
  "parentUuid": "<string>",
  "parentKey": "<string>",
  "connectionId": "<string>",
  "instanceKey": "<string>",
  "isUniversal": true,
  "externalAppId": "<string>",
  "externalAppUuid": "<string>",
  "externalAppKey": "<string>",
  "inputSchema": {},
  "config": {},
  "outputMapping": "<unknown>",
  "customOutputSchema": {},
  "isCustomized": true,
  "userId": "<string>",
  "tenantId": "<string>",
  "ownerName": "<string>",
  "agentSessionId": "<string>",
  "universalParentId": "<string>",
  "outputSchema": {},
  "isPublic": true,
  "logoUri": "<string>",
  "appliedToIntegrations": [
    {
      "element": {
        "id": "<string>",
        "name": "<string>",
        "uuid": "<string>",
        "key": "<string>",
        "description": "<string>",
        "meta": {},
        "errors": [
          {}
        ],
        "revision": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "archivedAt": "<string>",
        "isDeactivated": true,
        "isReadOnly": true,
        "integrationId": "<string>",
        "integrationUuid": "<string>",
        "integrationKey": "<string>",
        "parentId": "<string>",
        "parentUuid": "<string>",
        "parentKey": "<string>",
        "connectionId": "<string>",
        "instanceKey": "<string>",
        "isUniversal": true,
        "externalAppId": "<string>",
        "externalAppUuid": "<string>",
        "externalAppKey": "<string>",
        "inputSchema": {},
        "config": {},
        "outputMapping": "<unknown>",
        "customOutputSchema": {},
        "isCustomized": true,
        "userId": "<string>",
        "tenantId": "<string>",
        "ownerName": "<string>",
        "agentSessionId": "<string>",
        "universalParentId": "<string>",
        "outputSchema": "<unknown>",
        "isPublic": true
      },
      "integrationId": "<string>"
    }
  ],
  "defaultOutputSchema": {},
  "transformedOutputSchema": {},
  "dependencies": [
    "<unknown>"
  ]
}

POST

actions

create-action

curl --request POST \
  --url https://api.getmembrane.com/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "config": {},
  "key": "<string>",
  "description": "<string>",
  "inputSchema": {},
  "connectionId": "<string>",
  "integrationId": "<string>"
}
'

import requests

url = "https://api.getmembrane.com/actions"

payload = {
    "name": "<string>",
    "type": "<string>",
    "config": {},
    "key": "<string>",
    "description": "<string>",
    "inputSchema": {},
    "connectionId": "<string>",
    "integrationId": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    config: {},
    key: '<string>',
    description: '<string>',
    inputSchema: {},
    connectionId: '<string>',
    integrationId: '<string>'
  })
};

fetch('https://api.getmembrane.com/actions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getmembrane.com/actions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'config' => [
        
    ],
    'key' => '<string>',
    'description' => '<string>',
    'inputSchema' => [
        
    ],
    'connectionId' => '<string>',
    'integrationId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.getmembrane.com/actions"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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))

}

HttpResponse<String> response = Unirest.post("https://api.getmembrane.com/actions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getmembrane.com/actions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"config\": {},\n  \"key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"inputSchema\": {},\n  \"connectionId\": \"<string>\",\n  \"integrationId\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "uuid": "<string>",
  "key": "<string>",
  "description": "<string>",
  "meta": {},
  "errors": [
    {}
  ],
  "revision": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "archivedAt": "<string>",
  "isDeactivated": true,
  "isReadOnly": true,
  "integrationId": "<string>",
  "integrationUuid": "<string>",
  "integrationKey": "<string>",
  "parentId": "<string>",
  "parentUuid": "<string>",
  "parentKey": "<string>",
  "connectionId": "<string>",
  "instanceKey": "<string>",
  "isUniversal": true,
  "externalAppId": "<string>",
  "externalAppUuid": "<string>",
  "externalAppKey": "<string>",
  "inputSchema": {},
  "config": {},
  "outputMapping": "<unknown>",
  "customOutputSchema": {},
  "isCustomized": true,
  "userId": "<string>",
  "tenantId": "<string>",
  "ownerName": "<string>",
  "agentSessionId": "<string>",
  "universalParentId": "<string>",
  "outputSchema": {},
  "isPublic": true,
  "logoUri": "<string>",
  "appliedToIntegrations": [
    {
      "element": {
        "id": "<string>",
        "name": "<string>",
        "uuid": "<string>",
        "key": "<string>",
        "description": "<string>",
        "meta": {},
        "errors": [
          {}
        ],
        "revision": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "archivedAt": "<string>",
        "isDeactivated": true,
        "isReadOnly": true,
        "integrationId": "<string>",
        "integrationUuid": "<string>",
        "integrationKey": "<string>",
        "parentId": "<string>",
        "parentUuid": "<string>",
        "parentKey": "<string>",
        "connectionId": "<string>",
        "instanceKey": "<string>",
        "isUniversal": true,
        "externalAppId": "<string>",
        "externalAppUuid": "<string>",
        "externalAppKey": "<string>",
        "inputSchema": {},
        "config": {},
        "outputMapping": "<unknown>",
        "customOutputSchema": {},
        "isCustomized": true,
        "userId": "<string>",
        "tenantId": "<string>",
        "ownerName": "<string>",
        "agentSessionId": "<string>",
        "universalParentId": "<string>",
        "outputSchema": "<unknown>",
        "isPublic": true
      },
      "integrationId": "<string>"
    }
  ],
  "defaultOutputSchema": {},
  "transformedOutputSchema": {},
  "dependencies": [
    "<unknown>"
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

Display name. Optional on create; used to generate key when key is omitted.

type

string

required

Determines which handler runs and which config schema is used for validation (e.g. "run-javascript", "api-request-to-external-app").

config

object

required

Type-specific configuration object. Validated by the handler's config schema; passed to handler setup/run and getTemplateOutputSchema. For type "run-javascript", config.code uses this contract: action.run-javascript: input { input: unknown, user: unknown, connection: { id: string, name: string }, integration: { id: string, key?: string, name?: string } | undefined } + custom-code runtime clients -> unknown. Full contract: doc:functions/action-run-javascript.

Show child attributes

key

string

Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.

description

string

Optional human-readable description.

inputSchema

object

JSON Schema for the action input. Used by the action engine for template output schema, run-time variables, and output mapping.

Show child attributes

connectionId

string

Connection ID for filtering or for connection-level instances. Same semantics as base integration-level property.

integrationId

string

Internal ID of the integration this element belongs to. Omit for universal elements; set for integration-specific elements. Uniqueness of key is scoped per integration.

Response

200 - application/json

Create a new action for a connection or integration. Returns the created action object including its ID.

string

required

Internal database ID of the element. Assigned by the API; unique per element.

name

string

required

Display name. Always present in API responses (filled by API if not set on create).

uuid

string

Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.

key

string

Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.

description

string

Optional human-readable description.