Paragon

https://docs.useparagon.com/
Admin
Paragon is an embedded integration platform for B2B SaaS and AI products that enables native product...
Tokens:989,016
Snippets:5,122
Trust Score:9.3
Update:2 months ago
Show doc for...
Tokens:
Raw
### Agent Starter Prompts for Paragon Skills

Source: https://docs.useparagon.com/building-with-agents

Example prompts to trigger the Paragon Setup Skill for common tasks like SDK installation, catalog building, and authentication setup.

```markdown
/paragon-setup-skill Look at my app and set up the Paragon SDK, including all dependencies and required setup steps.

I will provide the following environment variables for your reference:
- `PARAGON_PROJECT_ID`: The Paragon Project UUID.
- `PARAGON_SIGNING_KEY`: The Signing Key as a PKCS8-encoded private key.
```

```markdown
/paragon-setup-skill Build an integration catalog for the integrations defined in my Paragon project.
```

```markdown
/paragon-setup-skill Set up auth for using the Paragon SDK.
```

--------------------------------

### Start an Install Flow

Source: https://docs.useparagon.com/connect-portal/headless-connect-portal

Initiate the integration installation process using the Paragon SDK, handling lifecycle events through callbacks.

```javascript
paragon.installFlow
  .start(props.integration, {
    onNext: (next) => {
      // Handle next install stage by presenting or updating UI for user input
    },
    onComplete: () => {
      // Installation has completed successfully
    },
    onError: (error, errorContext) => {
      // Handle error messaging
    }
  });
```

--------------------------------

### Start Install Flow with User-Configured OAuth

Source: https://docs.useparagon.com/resources/user-configured-oauth

Initiate the installation flow by specifying the accountType array to include user-configured OAuth options.

```javascript
paragon.installFlow.start("zendesk", {
  accountType: ["default", "user-configured-oauth"],
  onNext: (next) => {
    // Render the appropriate UI for the current install stage
  },
  onComplete: () => {
    // Installation has completed successfully
  },
});
```

--------------------------------

### Clone and Install Project

Source: https://docs.useparagon.com/paragraph/getting-started

Clone an existing repository and install the necessary project dependencies.

```bash
git clone git@github.com:useparagon/integrations.git
para install
```

--------------------------------

### PostOptionsStage Example

Source: https://docs.useparagon.com/apis/api-reference

Used to finalize account setup after the OAuth flow. The credentialId can be used with paragon.getFieldOptions for dynamic inputs.

```javascript
{
  "stage": "postOptions",
  "credentialId": "987654-56a7-89b1-cd23-456789abcdef",
  "options": [
    {
      "id": "JIRA_CLOUD_ID",
      "type": "DYNAMIC_ENUM",
      "title": "Choose a Jira site to connect.",
      "subtitle": "The Jira site, where all operations will be performed.",
      "sourceType": "getAvailableSites",
      "required": true
    }
  ],
  "done": false
}
```

--------------------------------

### Construct Installation URL

Source: https://docs.useparagon.com/resources/integrations/salesforce

Format the installation URL using the Subscriber Package Version ID.

```text
https://login.salesforce.com/packaging/installPackage.apexp?p0=YOUR_SUBSCRIBER_PACKAGE_VERSION_ID
```

--------------------------------

### Install Dependencies

Source: https://docs.useparagon.com/actionkit/actionkit-playground

Install all required project dependencies using pnpm.

```bash
pnpm install
```

--------------------------------

### Install Integration for New or Existing Accounts

Source: https://docs.useparagon.com/apis/api-reference/multi-account-authorization

Manage integration installation with the allowMultipleCredentials flag to support multiple accounts.

```javascript
const { credential } = await paragon.installIntegration("googledrive", {
  allowMultipleCredentials: true
});
```

```javascript
paragon.installIntegration("googledrive", {
  allowMultipleCredentials: true,
  selectedCredentialId: "0d2cca60-268b-45f1-ac5e-af6aad403d8c"
});
```

--------------------------------

### Install Salesforce CLI

Source: https://docs.useparagon.com/resources/integrations/salesforce

Install the Salesforce CLI globally using npm.

```bash
npm install -g @salesforce/cli
```

--------------------------------

### Install Integration with Multiple Credentials

Source: https://docs.useparagon.com/apis/api-reference/multi-account-authorization

Enable multiple account support by setting allowMultipleCredentials to true during integration installation.

```javascript
// Connect a new Google Calendar account
paragon.installIntegration("googleCalendar", {
    allowMultipleCredentials: true,

    // Set to true to show User Settings after installation:
    showPortalAfterInstall: true
});
```

--------------------------------

### Set user metadata examples

Source: https://docs.useparagon.com/apis/api-reference

Concrete examples of setting user metadata via SDK and REST API.

```typescript
paragon.setUserMetadata({
  Name: "Sean V",
  Email: "sean@useparagon.com",
  apiKey: "key_Y0kBVldPFInxK",
});
```

```http
PATCH https://api.useparagon.com/projects/<Project ID>/sdk/me

// Headers
Authorization: <Paragon User Token>
Content-Type: application/json

// Body
{ "meta": { "Email": "sean@useparagon.com", "apiKey": "key_Y0kBVldPFInxK" } }
```

--------------------------------

### Global SDK event subscription examples

Source: https://docs.useparagon.com/apis/api-reference

Examples of subscribing to integration, workflow, and portal events globally.

```typescript
type IntegrationInstallEvent = {
  integrationId: string;
  integrationType: VisibleConnectAction;
  credential: Credential;
  credentialId: string;
};

// Using global subscribe
paragon.subscribe(
  "onIntegrationInstall",
  (event: IntegrationInstallEvent, user: AuthenticatedConnectUser) => {
    /* ... */
  }
);
```

```typescript
type WorkflowStateChangeEvent = {
  integrationId: string;
  workflowId: string;
};

// Using global subscribe
paragon.subscribe(
  "onWorkflowChange",
  (event: WorkflowStateChangeEvent, user: AuthenticatedConnectUser) => {
    /* ... */
  }
);
```

```typescript
type PortalOpenEvent = {
  integrationId: string;
  integrationType: VisibleConnectAction;
};

type PortalCloseEvent = {
  integrationId: string;
  integrationType: VisibleConnectAction;
};

// Using global subscribe
paragon.subscribe(
  "onPortalOpen",
  (event: PortalOpenEvent, user: AuthenticatedConnectUser) => {
    /* ... */
  }
);
paragon.subscribe(
  "onPortalClose",
  (event: PortalCloseEvent, user: AuthenticatedConnectUser) => {
    /* ... */
  }
);
```

--------------------------------

### Install Paragon CLI

Source: https://docs.useparagon.com/paragraph/getting-started

Install the Paragon CLI globally using npm to access the 'para' command.

```bash
npm install -g @useparagon/cli
```

--------------------------------

### Start the Development Server

Source: https://docs.useparagon.com/actionkit/actionkit-playground

Launch the application locally on port 3000.

```bash
pnpm dev
```

--------------------------------

### Outreach Get Prospects Pagination Example

Source: https://docs.useparagon.com/actionkit/integrations/outreach/OUTREACH_GET_PROSPECTS

Example of a pagination token used to fetch the next page of records from the Outreach API.

```json
"eyJjbiI6IkFwaVYyOjpQcm9zcGVjdHNDb250cm9sbGVyIiwic3AiOm51bGwsInN2IjpbXSwiaWQiOjEwMiwidiI6MX0%3D"
```

--------------------------------

### Tool API Response Example

Source: https://docs.useparagon.com/tutorials/actionkit-guide/first-action

A sample JSON response structure returned by the GET Tools endpoint.

```json
{
  "tools": {
    "hubspot": [
      {
        "type": "function",
        "function": {
          "name": "HUBSPOT_CREATE_RECORD_CONTACTS",
          "description": "Create a contact in HubSpot CRM",
          "parameters": {
            "type": "object",
            "properties": {
              "field-email": {
                "type": "string",
                "description": "Email"
              },
              "field-firstname": {
                "type": "string",
                "description": "First Name"
              },
              "field-lastname": {
                "type": "string",
                "description": "Last Name"
              },
              "field-jobtitle": {
                "type": "string",
                "description": "Job Title"
              },
              "field-company": {
                "type": "string",
                "description": "Company Name"
              },
              "field-hubspot_owner_id": {
                "type": "string",
                "description": "Contact Owner: The HubSpot user who is assigned to this contact. Use Connect Portal Workflow Settings to allow users to select an Owner. (example value: \"{{settings.owner}}\")"
              },
              "field-lifecyclestage": {
                "type": "string",
                "description": "Lifecycle Stage: Defaults to the user's first Lifecycle Stage if not provided. Use Connect Portal Workflow Settings to allow users to select a Lifecycle Stage. (example value: \"{{settings.lifecycleStage}}\")"
              },
              "field-hs_lead_status": {
                "type": "string",
                "description": "Lead Status: Defaults to the user's first Lead Status if not provided. Use Connect Portal Workflow Settings to allow users to select a Lead Status. (example value: \"{{settings.leadStatus}}\")"
              },
              "additionalFieldsJSON": {
                "type": "string",
                "description": "Additional Fields: Specify any other fields that should be updated in JSON below. Use Connect Portal Workflow Settings to allow users to select which Contact fields to update. (example value: \"{\n  \"property_number\": \"17\",\n  \"property_dropdown\": \"choice_b\",\n  \"property_radio\": \"option_1\",\n  \"property_string\": \"value\",\n  \"property_date\": \"1572480000000\"\n}\")"
              }
            },
            "required": [
              "recordType",
              "field-email"
            ],
            "additionalProperties": false,
            "$schema": "http://json-schema.org/draft-07/schema#"
          }
        }
      }
    ]
  },
  "errors": []
}
```

--------------------------------

### Configure Environment Variables

Source: https://docs.useparagon.com/actionkit/actionkit-playground

Create the local environment configuration file from the provided example.

```bash
cp .env.example .env.local
```

--------------------------------

### Get Example Payload OpenAPI Definition

Source: https://docs.useparagon.com/actionkit/triggers/api-reference/get-example-payload

The OpenAPI specification for the POST /projects/{project_id}/triggers/examples endpoint.

```yaml
openapi: 3.0.0
info:
  title: Triggers API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/triggers/examples:
    post:
      summary: Get Example Payload
      description: >-
        Get example records for a trigger. Use this to preview what an incoming
        event payload could look like.
      operationId: getExamplePayload
      parameters:
        - $ref: '#/components/parameters/ProjectId'
        - $ref: '#/components/parameters/CredentialHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTriggerExamplesRequest'
            example:
              type: SALESFORCE_TRIGGER_RECORD_CREATED
              integration: salesforce
              parameters:
                recordType: Opportunity
      responses:
        '200':
          description: >-
            Success - Returns array of example records that could be returned
            from the trigger
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: Example records that could be returned from the trigger
                  additionalProperties: true
              example:
                - id: 001xx000003DHP0AAO
                  name: Sample Opportunity
                  amount: 50000
                  stage: Prospecting
                  closeDate: '2025-12-31'
      security:
        - BearerAuth: []
components:
  parameters:
    ProjectId:
      name: project_id
      in: path
      required: true
      schema:
        type: string
        description: Your Paragon Project ID
    CredentialHeader:
      name: X-Paragon-Credential
      in: header
      required: false
      schema:
        type: string
        format: uuid
        description: >-
          Specify a credential ID when multiple accounts are connected for the
          same integration
  schemas:
    GetTriggerExamplesRequest:
      type: object
      properties:
        type:
          type: string
          description: >-
            The trigger type identifier (e.g.
            SALESFORCE_TRIGGER_RECORD_CREATED).
          example: SALESFORCE_TRIGGER_RECORD_CREATED
        integration:
          type: string
          description: The integration name for the trigger (e.g. salesforce, hubspot).
          example: salesforce
        parameters:
          type: object
          description: >-
            Trigger configuration parameters, same shape as `parameters` in
            [Subscribe to a
            Trigger](/actionkit/triggers/api-reference/subscribe-to-trigger).
          additionalProperties: true
          example:
            recordType: Opportunity
      required:
        - type
        - integration
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.
```

--------------------------------

### Connect and Install Integrations in JavaScript

Source: https://docs.useparagon.com/apis/api-reference/multi-account-authorization

Use installIntegration for new accounts and connect for existing accounts when multiple credentials are enabled.

```javascript
// Connect a new account for this integration.
// NOTE: You must use `paragon.installIntegration` rather than `paragon.connect`.
paragon.installIntegration("salesforce", {
  allowMultipleCredentials: true
});

// Show the Connect Portal to configure an existing account for this integration.
paragon.connect("salesforce", {
  selectedCredentialId: "de06dea8-8680-483c-95ea-cfcf66582c96"
});
```

--------------------------------

### paragon.installFlow.start

Source: https://docs.useparagon.com/apis/api-reference

Initiates an install flow for a specific integration type. This method accepts configuration options for handling flow progression, completion, and error states.

```APIDOC
## paragon.installFlow.start

### Description
Starts the installation flow for a specified integration. This is used to guide users through connecting their accounts.

### Method
SDK Method

### Signature
paragon.installFlow.start(integrationType, options)

### Parameters
- **integrationType** (string) - Required - The integration type string, e.g., 'salesforce'.
- **options** (object) - Required - Configuration object for the flow.
  - **onNext(nextStage)** (function) - Optional - Callback triggered when the flow moves to the next stage.
  - **onComplete()** (function) - Optional - Callback triggered when the flow completes successfully.
  - **onError(error, context)** (function) - Optional - Callback triggered on failure.
  - **oauthTimeout** (number) - Optional - Milliseconds to wait for OAuth completion.
  - **allowMultipleCredentials** (boolean) - Optional - Enables multi-account authorization if set to true.
  - **selectedCredentialId** (string) - Optional - Credential ID to replace an existing account.
  - **overrideRedirectUrl** (string) - Optional - Redirect URL for specific integrations.
```

--------------------------------

### HTTP Proxy Request Structure

Source: https://docs.useparagon.com/actionkit/custom-tools

Example of a GET request to the Google Drive API routed through the Paragon Proxy.

```http
GET https://proxy.useparagon.com/projects/[Project ID]/sdk/proxy/googledrive

Authorization: Bearer [Paragon User Token]
X-Paragon-Proxy-Url: https://www.googleapis.com/drive/v3/files/{fileId}/comments
```

--------------------------------

### Upload and Open Project

Source: https://docs.useparagon.com/resources/integrations/hubspot

Commands to deploy the project to the developer account and open it in the browser.

```bash
hs project upload
```

```bash
hs project open
```

--------------------------------

### Configure User-Configured OAuth for Jira

Source: https://docs.useparagon.com/resources/integrations/jira

Examples for enabling user-configured OAuth during the integration installation flow, either as an additional option or as the exclusive method.

```js
// Allow user-configured OAuth as an option (defaults to hidden)
paragon.installIntegration("jira", {
  accountType: paragon
    .getAccountTypeOptions("jira")
    .map((option) => option.id),
});

// Only allow user-configured OAuth accounts to connect
paragon.installIntegration("jira", {
  accountType: ["user-configured-oauth"],
});
```

--------------------------------

### Get workflow execution details JSON response

Source: https://docs.useparagon.com/apis/task-history

Example of a successful 200 OK response when retrieving details for a specific workflow execution.

```json
{
    "id": "daff08e3-c299-4005-9799-be69090ebae1",
    "userId": "test",
    "taskCount": 1,
    "runDuration": 8,
    "workflowId": "88d20d69-e585-4eea-aac4-5b7aea0521e8",
    "status": "FAILED",
    "dateEnded": "2022-11-25T22:15:07.987Z",
    "dateStarted": "2022-11-25T22:15:00.038Z",
    "stepExecutions": [
        {
            "id": "5fec7d78-7e10-4b4a-bdfc-292f629774bf",
            "stepId": "0f7cce44-d292-4555-bae8-5b904a0c4ac9",
            "workflowExecutionId": "daff08e3-c299-4005-9799-be69090ebae1",
            "status": "SUCCEEDED",
            "type": "TRIGGER/CRON",
            "start": "2022-11-25T22:15:00.075Z",
            "end": "2022-11-25T22:15:00.084Z",
            "next": [
                "29e675eb-0910-4d5c-8a5c-a4a4c1895605"
            ],
            "prev": null,
            "inputSize": "220",
            "outputSize": "76"
        },
        {
            "id": "29e675eb-0910-4d5c-8a5c-a4a4c1895605",
            "stepId": "7459bbf5-e55b-49e8-9390-084cf86752e5",
            "workflowExecutionId": "daff08e3-c299-4005-9799-be69090ebae1",
            "status": "FAILED",
            "type": "ACTION/REQUEST",
            "start": "2022-11-25T22:15:07.850Z",
            "end": "2022-11-25T22:15:07.873Z",
            "next": [],
            "prev": "5fec7d78-7e10-4b4a-bdfc-292f629774bf",
            "inputSize": "712",
            "outputSize": "824"
        }
    ]
}
```

--------------------------------

### Initialize Salesforce Project

Source: https://docs.useparagon.com/resources/integrations/salesforce

Generate a new Salesforce DX project structure.

```bash
sf project generate --name YourProjectName
```

--------------------------------

### Initialize Paragon Project

Source: https://docs.useparagon.com/paragraph/getting-started

Create a new project from an existing dashboard entry or initialize a new empty project.

```bash
para init --create-from-existing
```

```bash
para init new-project-name
```

--------------------------------

### OpenAPI Specification for Get Available Times For Event Type

Source: https://docs.useparagon.com/actionkit/integrations/calendly/CALENDLY_GET_AVAILABLE_TIMES_FOR_EVENT_TYPE

Defines the POST endpoint for fetching Calendly availability, requiring project ID, event type, start time, and end time.

```yaml
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#CALENDLY_GET_AVAILABLE_TIMES_FOR_EVENT_TYPE:
    post:
      summary: Get Available Times For Event Type
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: CALENDLY_GET_AVAILABLE_TIMES_FOR_EVENT_TYPE
                parameters:
                  type: object
                  properties:
                    event_type:
                      type: string
                      description: >-
                        Event Type : Specify the event type to fetch. (example:
                        "https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA")
                    start_time:
                      type: string
                      description: >-
                        Start Time : Specify a start time for the event
                        availability to fetch. (example:
                        "2022-01-02T24:00:00.000000Z")
                    end_time:
                      type: string
                      description: >-
                        End Time : Specify an end time for the event
                        availability to fetch. (example:
                        "2022-01-07T24:00:00.000000Z")
                  required:
                    - event_type
                    - start_time
                    - end_time
                  x-integration: calendly
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.
```

--------------------------------

### paragon.installIntegration

Source: https://docs.useparagon.com/apis/api-reference/multi-account-authorization

Starts the connection process for a new account of an integration. Supports multiple credentials by passing allowMultipleCredentials: true.

```APIDOC
## paragon.installIntegration(integrationId, options)

### Description
Initiates the connection flow for a new integration account.

### Parameters
- **integrationId** (string) - Required - The ID of the integration.
- **options** (object) - Optional - Configuration object containing `allowMultipleCredentials` and `selectedCredentialId`.

### Example
```javascript
const { credential } = await paragon.installIntegration("googledrive", {
  allowMultipleCredentials: true
});
```
```

--------------------------------

### Paragon SDK Setup Prompt

Source: https://docs.useparagon.com/tutorials/actionkit-guide/first-action

Prompt for the coding agent to configure the Paragon SDK and dependencies.

```markdown
/paragon-setup-skill Look at my app and set up the Paragon SDK, including all dependencies and required setup steps.

I will provide the following environment variables for your reference:
- `PARAGON_PROJECT_ID`: The Paragon Project UUID.
- `PARAGON_SIGNING_KEY`: The Signing Key as a PKCS8-encoded private key.
```

--------------------------------

### Section ID Example

Source: https://docs.useparagon.com/actionkit/integrations/onenote/ONENOTE_CREATE_PAGE

Example of a valid Section ID string.

```text
1-q3259d12-4211-459f-bdf0-2a2a21054865
```

--------------------------------

### Initialize with developer key

Source: https://docs.useparagon.com/apis/api-reference

Example of initializing the picker with a required developer key.

```javascript
await picker.init({
  developerKey: "AIzaS...",
});
```

--------------------------------

### HTML Content Example

Source: https://docs.useparagon.com/actionkit/integrations/onenote/ONENOTE_CREATE_PAGE

Example structure for providing HTML content for a OneNote page.

```html
<!DOCTYPE html>
<html>
  <head>
    <title>A page with a block of HTML</title>
    <meta name="created" content="2015-07-22T09:00:00-08:00" />
  </head>
  <body>
    <p>This page contains some <i>formatted</i> <b>text</b> and an image.</p>
    <img src="https://..." alt="an image on the page" width="500" />
  </body>
</html>
```

--------------------------------

### Initialize the picker instance

Source: https://docs.useparagon.com/apis/api-reference

Loads required dependencies and prepares the picker. Must be awaited before calling open or getInstance.

```javascript
await picker.init(initConfig);
```

--------------------------------

### Install Paragon SDK

Source: https://docs.useparagon.com/getting-started/installing-the-connect-sdk

Use your preferred package manager to add the Paragon Connect SDK to your project dependencies.

```bash
npm install @useparagon/connect
```

```bash
yarn add @useparagon/connect
```

```bash
pnpm add @useparagon/connect
```

```bash
bun add @useparagon/connect
```

--------------------------------

### Multipart Content Example

Source: https://docs.useparagon.com/actionkit/integrations/onenote/ONENOTE_CREATE_PAGE

Example structure for providing multipart content including images and files.

```json
{
  "imageBlock1": {
    "content": <Buffer ...>,
    "contentType": "image/jpeg",
    "fileName": "imageBlock1"
  },
  "fileBlock1": {
    "content": <Buffer ...>,
    "contentType": "application/pdf",
    "fileName": "fileBlock1"
  }
}
```

--------------------------------

### Additional Fields JSON Example

Source: https://docs.useparagon.com/actionkit/integrations/bamboohr/BAMBOO_HR_UPDATE_EMPLOYEE

Example structure for the additionalFields parameter when updating employee details.

```json
{
  jobTitle: "Accountant",
  nickname: "John",
  address2: "Seattle"
}
```

--------------------------------

### Create Managed Package

Source: https://docs.useparagon.com/resources/integrations/salesforce

Initialize a managed package for the application.

```bash
sf package create \
  --name "Your App Display Name" \
  --package-type Managed \
  --path force-app \
  --target-dev-hub DevHub \
  --error-notification-username your-email@example.com
```

--------------------------------

### Install and Authenticate HubSpot CLI

Source: https://docs.useparagon.com/resources/integrations/hubspot

Commands to install the HubSpot CLI globally and authenticate with a developer account.

```bash
npm install -g @hubspot/cli
```

```bash
hs account auth
```

--------------------------------

### Install an integration headlessly

Source: https://docs.useparagon.com/apis/api-reference

Initiates the connection process for a specific integration type without showing the Connect Portal UI.

```javascript
const { credential } = await paragon.installIntegration(integrationType, installOptions);
```

--------------------------------

### Run Database Migration

Source: https://docs.useparagon.com/actionkit/actionkit-playground

Initialize the local SQLite database by executing the migration script.

```bash
pnpm migrate
```

--------------------------------

### REST API request example

Source: https://docs.useparagon.com/apis/proxy

Example of a POST request to the Slack API via the Proxy endpoint.

```bash
POST https://proxy.useparagon.com/projects/19d...012/sdk/proxy/slack/chat.postMessage

Authorization: Bearer eyJ...
Content-Type: application/json

{ 
    "channel": "CXXXXXXX0", 
    "text": "This message was sent with Paragon Connect :exploding_head:"
}
```

--------------------------------

### Notion Icon Object Example

Source: https://docs.useparagon.com/actionkit/integrations/notion/NOTION_UPDATE_PAGE_WITH_MARKDOWN

Example of the emoji object structure used for setting a page icon.

```json
{
  "emoji":"🥬"
}
```

--------------------------------

### Handle Redirect Callback

Source: https://docs.useparagon.com/resources/integrations/shopify

Logic for parsing the authorization code and shop name from query parameters to complete the installation using paragon.completeInstall.

```javascript
let params = new URLSearchParams(window.location.search);
let authorizationCode = params.get("code");
let [, shopName] = params.get("shop").match(/^([a-zA-Z0-9][a-zA-Z0-9\-]*).myshopify.com/);

if (authorizationCode && shopName) {
   paragon.completeInstall("shopify", {
    authorizationCode: authorizationCode,
    redirectUrl: "https://your-app.url/shopify-redirect",
    integrationOptions: {
      SHOP_NAME: shopName,
    }
  }).then(() => {
     // Redirect to your app's integrations page
  });
} else {
  let error = params.get("error");
  // Handle error
}
```
Tokens:
Raw