# Execute integration action

Executes a specific action for an integration with the provided parameters. For example, create a Notion page or send a Slack message.

Endpoint: POST /skills/{integration}/actions/{action}/execute
Version: 1.0.0
Security: ApiKeyAuth, OrgIdAuth

## Path parameters:

  - `integration` (string, required)
    Integration identifier (e.g., notion, slack, salesforce)
    Example: "notion"

  - `action` (string, required)
    Action identifier for the integration
    Example: "NOTION_CREATE_PAGE"

## Request fields (application/json):

  - `parameters` (object)
    Parameters to pass to the action
    Example: {"parent":{"database_id":"abc123"},"properties":{"Name":{"title":[{"text":{"content":"My New Page"}}]}}}

## Response 200 fields (application/json):

  - `result` (object)
    The result returned by the integration action

## Response 400 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"

## Response 401 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"

## Response 403 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"

## Response 404 fields (application/json):

  - `error` (string)
    Error message
    Example: "Missing required headers"

  - `details` (string)
    Additional error details
    Example: "x-api-key and x-org-id headers are required"

## Response 502 fields (application/json):

  - `error` (string)

  - `details` (string)