SDK / API Reference

[{
  "id": "2f08e65f-d924-42ab-9618-b6023d82ffbd",
  "projectId": "908f4c5e-6394-46a5-9355-3f729edbd160",
  "customIntegrationId": null,
  "type": "slack",
  "isActive": true,
  "configs": [
    {
      "id": "3ebcc179-a1a6-447f-8dc9-5017f40f08ef",
      "values": {
        "overview": "####Our Slack integration enables you to:\n   \n\n• Receive alerts and notifications in your Slack workspace\n• Notify or DM specific team members based on certain activity",
        "sharedMeta": {},
        "accentColor": "#4A154B",
        "description": "Send notifications to Slack",
        "workflowMeta": {}
      }
    },
  ],
  "workflows": [
    {
      "id": "1b22193b-e355-458d-b6a3-5e5516edb588",
      "description": "Send Updates to Slack",
      "projectId": "908f4c5e-6394-46a5-9355-3f729edbd160",
      "integrationId": "2f08e65f-d924-42ab-9618-b6023d82ffbd",
      "steps": []
    }
  ],
  "customIntegration": null,
  "hasCredential": true,
  "connectedUserLimitOnDevCred": 0,
  "connectedUserLimitReached": true,
  "name": "Slack",
  "brandColor": "#4A154B",
  "needPreOauthInputs": false,
  "providerType": "slack",
  "authenticationType": "oauth"
}]

const config = paragon.getIntegrationConfig("salesforce");
const input = config.availableUserSettings[0];
// { id: "...", type: "FIELD_MAPPER", title: "Map fields", sourceType: "customObjectMapping" }

const sources = paragon.getSourcesForInput("salesforce", input);
// { kind: "fieldMapper", recordSource: {...}, fieldSource: {...} }

if (sources?.kind === "fieldMapper") {
  // Load record types
  const recordTypes = await paragon.getFieldOptions({
    integration: "salesforce",
    source: sources.recordSource,
  });

  // Load fields for a selected record type
  const fields = await paragon.getFieldOptions({
    integration: "salesforce",
    source: sources.fieldSource,
    parameters: [{
      key: sources.recordSource.cacheKey,
      source: { type: "VALUE", value: "Task" },
    }],
  });
}

const config = paragon.getIntegrationConfig("jira");
const input = config.availableUserSettings[0];
// { id: "...", type: "COMBO_INPUT", sourceType: "projectIssueStatusTypeCombo" }

const sources = paragon.getSourcesForInput("jira", input);
// { kind: "combo", mainInputSource: {...}, dependentInputSource: {...} }

if (sources?.kind === "combo") {
  // Load main options (e.g. Projects)
  const projects = await paragon.getFieldOptions({
    integration: "jira",
    source: sources.mainInputSource,
  });

  // Load dependent options (e.g. Issue Statuses for a selected Project)
  const statuses = await paragon.getFieldOptions({
    integration: "jira",
    source: sources.dependentInputSource,
    parameters: [{
      key: sources.mainInputSource.cacheKey,
      source: { type: "VALUE", value: "PROJECT-1" },
    }],
  });
}

const config = paragon.getIntegrationConfig("salesforce");
const input = config.availableUserSettings[0];
// { id: "...", type: "DYNAMIC_COMBO_INPUT", sourceType: "dynamicComboAction" }

const sources = paragon.getSourcesForInput("salesforce", input);
// { kind: "defaultFieldValue", mainInputSource: {...}, dependentInputSource: {...}, variableInputSource: {...} }

if (sources?.kind === "defaultFieldValue") {
  const mainOptions = await paragon.getFieldOptions({
    integration: "salesforce",
    source: sources.mainInputSource,
  });

  const dependentOptions = await paragon.getFieldOptions({
    integration: "salesforce",
    source: sources.dependentInputSource,
    parameters: [{
      key: sources.mainInputSource.cacheKey,
      source: { type: "VALUE", value: mainOptions.data[0].value },
    }],
  });
}