Retrieve a custom action definition

Recuperar uma definição de ação personalizada

curl --request GET \
  --url 'https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey='

const options = {method: 'GET'};

fetch('https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=', 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.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey="

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=")

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

request = Net::HTTP::Get.new(url)

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

{
  "actionUrl": "<string>",
  "functions": [
    {
      "functionType": "POST_ACTION_EXECUTION",
      "id": "<string>"
    }
  ],
  "id": "<string>",
  "inputFields": [
    {
      "isRequired": true,
      "typeDefinition": {
        "name": "<string>",
        "options": [
          {
            "label": "<string>",
            "value": "<string>",
            "description": "<string>",
            "displayOrder": 123
          }
        ],
        "type": "bool",
        "description": "<string>",
        "fieldType": "booleancheckbox",
        "helpText": "<string>",
        "label": "<string>",
        "optionsUrl": "<string>",
        "referencedObjectType": "OWNER"
      },
      "supportedValueTypes": [
        "STATIC_VALUE"
      ]
    }
  ],
  "labels": {},
  "objectTypes": [
    "<string>"
  ],
  "published": true,
  "revisionId": "<string>",
  "archivedAt": 123,
  "executionRules": [
    {
      "conditions": {},
      "labelName": "<string>"
    }
  ],
  "inputFieldDependencies": [
    {
      "controllingFieldName": "<string>",
      "dependencyType": "SINGLE_FIELD",
      "dependentFieldNames": [
        "<string>"
      ]
    }
  ],
  "objectRequestOptions": {
    "properties": [
      "<string>"
    ]
  },
  "outputFields": [
    {
      "typeDefinition": {
        "externalOptions": true,
        "name": "<string>",
        "options": [
          {
            "description": "<string>",
            "displayOrder": 123,
            "doubleData": 123,
            "hidden": true,
            "label": "<string>",
            "readOnly": true,
            "value": "<string>"
          }
        ],
        "schema": {
          "type": "INTEGER",
          "maximum": 123,
          "minimum": 123
        },
        "type": "bool",
        "useChirp": true,
        "description": "<string>",
        "externalOptionsReferenceType": "<string>",
        "fieldType": "booleancheckbox",
        "helpText": "<string>",
        "label": "<string>",
        "optionsUrl": "<string>",
        "referencedObjectType": "ABANDONED_CART"
      }
    }
  ]
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

GET

automation

actions

2026-09

{appId}

{definitionId}

Recuperar uma definição de ação personalizada

curl --request GET \
  --url 'https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey='

const options = {method: 'GET'};

fetch('https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=', 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.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey="

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/automation/actions/2026-09/{appId}/{definitionId}?hapikey=")

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

request = Net::HTTP::Get.new(url)

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

{
  "actionUrl": "<string>",
  "functions": [
    {
      "functionType": "POST_ACTION_EXECUTION",
      "id": "<string>"
    }
  ],
  "id": "<string>",
  "inputFields": [
    {
      "isRequired": true,
      "typeDefinition": {
        "name": "<string>",
        "options": [
          {
            "label": "<string>",
            "value": "<string>",
            "description": "<string>",
            "displayOrder": 123
          }
        ],
        "type": "bool",
        "description": "<string>",
        "fieldType": "booleancheckbox",
        "helpText": "<string>",
        "label": "<string>",
        "optionsUrl": "<string>",
        "referencedObjectType": "OWNER"
      },
      "supportedValueTypes": [
        "STATIC_VALUE"
      ]
    }
  ],
  "labels": {},
  "objectTypes": [
    "<string>"
  ],
  "published": true,
  "revisionId": "<string>",
  "archivedAt": 123,
  "executionRules": [
    {
      "conditions": {},
      "labelName": "<string>"
    }
  ],
  "inputFieldDependencies": [
    {
      "controllingFieldName": "<string>",
      "dependencyType": "SINGLE_FIELD",
      "dependentFieldNames": [
        "<string>"
      ]
    }
  ],
  "objectRequestOptions": {
    "properties": [
      "<string>"
    ]
  },
  "outputFields": [
    {
      "typeDefinition": {
        "externalOptions": true,
        "name": "<string>",
        "options": [
          {
            "description": "<string>",
            "displayOrder": 123,
            "doubleData": 123,
            "hidden": true,
            "label": "<string>",
            "readOnly": true,
            "value": "<string>"
          }
        ],
        "schema": {
          "type": "INTEGER",
          "maximum": 123,
          "minimum": 123
        },
        "type": "bool",
        "useChirp": true,
        "description": "<string>",
        "externalOptionsReferenceType": "<string>",
        "fieldType": "booleancheckbox",
        "helpText": "<string>",
        "label": "<string>",
        "optionsUrl": "<string>",
        "referencedObjectType": "ABANDONED_CART"
      }
    }
  ]
}

{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Required Scopes

Autorizações

hapikey

string

query

obrigatório

Parâmetros de caminho

appId

integer<int32>

obrigatório

O identificador exclusivo do aplicativo que contém a definição da extensão.

definitionId

string

obrigatório

O identificador exclusivo da definição de extensão a ser recuperada.

Parâmetros de consulta

archived

boolean

padrão:false

Se apenas os resultados que foram arquivados devem ser retornados.

Resposta

successful operation

actionUrl

string

obrigatório

O endpoint da URL onde a ação é executada. É uma string.

functions

object[]

obrigatório

Uma matriz de identificadores de função associados à ação, em que cada item é um PublicActionFunctionIdentifier.

Show child attributes

string

obrigatório

O identificador exclusivo para a definição da ação. É uma string.

inputFields

object[]

obrigatório

Uma matriz de definições de campo de entrada necessárias para a ação. Cada item é um objeto PublicInputFieldDefinition.

Show child attributes

labels

object

obrigatório

Um objeto que contém rótulos para a ação, com cada propriedade sendo um objeto PublicActionLabels.

Show child attributes

objectTypes

string[]

obrigatório

Uma matriz de strings que representam os tipos de objetos associados à ação.

published

boolean

obrigatório

Um booleano que indica se a ação está publicada e disponível para uso.

revisionId

string

obrigatório

O identificador exclusivo para a revisão atual da definição da ação. É uma string.

archivedAt

integer<int64>

Um carimbo de data/hora Unix em milissegundos que representa quando a ação foi arquivada. É um número inteiro.

executionRules

object[]

Uma matriz de regras de tradução de execução para a ação, em que cada item é uma PublicExecutionTranslationRule.

Show child attributes

inputFieldDependencies

(SINGLE_FIELD · object | CONDITIONAL_SINGLE_FIELD · object)[]

Uma matriz de dependências entre campos de entrada, em que cada item pode ser PublicSingleFieldDependency ou PublicConditionalSingleFieldDependency.

SINGLE_FIELD
CONDITIONAL_SINGLE_FIELD

Show child attributes

objectRequestOptions

object

Show child attributes

outputFields

object[]

Uma matriz de definições de campo de saída produzidas pela ação. Cada item é um objeto OutputFieldDefinition.

Show child attributes

Última modificação em 6 de outubro de 2026

Conta e configurações

Gerenciamento de aplicativo

Autenticação

Automação

CMS

Preferências de comunicação

Conversas

CRM

Data Studio

Eventos

Arquivos

Marketing

Reuniões

Receita

Webhooks

Diário de Webhooks

Retrieve a custom action definition

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta