Skip to main content
POST
/
projects
/
{project_id}
/
actions
Run Action
curl --request POST \
  --url https://actionkit.useparagon.com/projects/{project_id}/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "SLACK_SEND_MESSAGE",
  "parameters": {}
}
'
{
  "ok": true,
  "channel": "CSQCUNXBP",
  "ts": "1739896301.418839",
  "message": {
    "user": "U0101SYAC07",
    "type": "message",
    "ts": "1739896301.418839",
    "bot_id": "B0101SYAB3R",
    "app_id": "A01001G1G7J",
    "text": "test",
    "team": "TM7FL705V",
    "bot_profile": {
      "id": "B0101SYAB3R",
      "app_id": "A01001G1G7J",
      "name": "Paragon",
      "icons": {
        "image_36": "https://avatars.slack-edge.com/2020-03-24/1022919802484_c4af0a8de9e9c25f4b58_36.png",
        "image_48": "https://avatars.slack-edge.com/2020-03-24/1022919802484_c4af0a8de9e9c25f4b58_48.png",
        "image_72": "https://avatars.slack-edge.com/2020-03-24/1022919802484_c4af0a8de9e9c25f4b58_72.png"
      },
      "deleted": false,
      "updated": 1587073960,
      "team_id": "TM7FL705V"
    },
    "blocks": [
      {
        "type": "section",
        "block_id": "iAHFB",
        "text": {
          "type": "mrkdwn",
          "text": "test",
          "verbatim": false
        }
      }
    ]
  },
  "response_metadata": {
    "scopes": [
      "app_mentions:read",
      "chat:write",
      "chat:write.public",
      "channels:read",
      "reactions:write",
      "chat:write.customize",
      "im:read",
      "im:write",
      "users:read",
      "groups:read",
      "channels:manage",
      "groups:write",
      "mpim:write",
      "team:read",
      "channels:history",
      "users:read.email",
      "files:read",
      "files:write"
    ],
    "acceptedScopes": [
      "chat:write"
    ]
  }
}
This endpoint can be used to call any ActionKit Action on behalf of your user. You can find specific input parameters for an Action you want to call in the Actions Reference, for example: Each Action in the Reference is an example call to this endpoint.

Authorizations

​
Authorization
string
header
required

Your Paragon User Token (JWT), which you can generate using your project's signing keys.

Path Parameters

​
project_id
string
required

Your Paragon Project ID. You can copy your Project ID from your dashboard URL or by clicking Copy Project ID under the Environment switcher.

Body

application/json
​
action
string
required

The Action to run

Example:

"SLACK_SEND_MESSAGE"

​
parameters
object
required

The parameters to pass to the Action. See available parameters for your specific Action in the Actions Reference.

Response

Note: Responses will vary by integration provider. Paragon returns the API response of the last request that was used to run this Action.