Create Table Record with ServiceNow API on Completed Document (Instant) from signNow API

Pipedream makes it easy to connect APIs for ServiceNow, signNow and 3,000+ other apps remarkably fast.

Trigger workflow on

Completed Document (Instant) from the signNow API

Next, do this

Create Table Record with the ServiceNow API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a signNow trigger and ServiceNow action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Completed Document (Instant) trigger
1. Connect your signNow account
Configure the Create Table Record action
1. Connect your ServiceNow account
2. Select a Table
3. Configure Record Data
4. Optional- Select a Response Data Format
5. Optional- Configure Exclude Reference Links
6. Optional- Configure Response Fields
7. Optional- Configure Input Display Value
8. Optional- Select a Response View
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

Completed Document (Instant) on signNow

Description:Emit new event when all signers have filled in and signed the document. [See the documentation](https://docs.signnow.com/docs/signnow/webhooks/operations/create-a-api-v-2-event)

Version:0.0.1

Key:signnow-completed-document-instant

View on GitHub

Trigger Code#

import common from "../common/webhook.mjs";
import events from "../common/events.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "signnow-completed-document-instant",
  name: "Completed Document (Instant)",
  description: "Emit new event when all signers have filled in and signed the document. [See the documentation](https://docs.signnow.com/docs/signnow/webhooks/operations/create-a-api-v-2-event)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    async getEntityId() {
      const { id } = await this.app.getUserInfo();
      return id;
    },
    getEventName() {
      return events.USER_DOCUMENT_COMPLETE;
    },
    generateMeta(resource) {
      const {
        document_id: documentId,
        document_name: documentName,
      } = resource.content;
      const { timestamp: ts } = resource.meta;
      return {
        id: `${documentId}-${ts}`,
        summary: `Completed Document: ${documentName}`,
        ts,
      };
    },
  },
  sampleEmit,
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
signNow	`app`	`app`	This component uses the signNow app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.

Trigger Authentication#

signNow uses OAuth authentication. When you connect your signNow account, Pipedream will open a popup window where you can sign into signNow and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any signNow API.

Pipedream requests the following authorization scopes when you connect your account:

About signNow#

Electronic signature that scales with your workflow. Create and scale eSignature workflows with signNow, part of the airSlate Business Cloud. Sign and send documents for signing, generate agreements, negotiate contracts, accept payments, and automate business processes.

Action#

Create Table Record on ServiceNow

Description:Inserts one record in the specified table. [See the documentation](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html#title_table-POST)

Version:1.0.0

Key:servicenow-create-table-record

View on GitHub

ServiceNow Overview#

The ServiceNow API lets developers access and manipulate records, manage workflows, and integrate with other services on its IT service management platform. These capabilities support automating tasks, syncing data across platforms, and boosting operational efficiencies.

Action Code#

import servicenow from "../../servicenow.app.mjs";
import { parseObject } from "../../common/utils.mjs";

export default {
  key: "servicenow-create-table-record",
  name: "Create Table Record",
  description: "Inserts one record in the specified table. [See the documentation](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html#title_table-POST)",
  version: "1.0.0",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    servicenow,
    table: {
      propDefinition: [
        servicenow,
        "table",
      ],
    },
    recordData: {
      label: "Record Data",
      type: "object",
      description: "The data to create the record with, as key-value pairs (e.g. `{ \"name\": \"John Doe\", \"email\": \"john.doe@example.com\" }`)",
    },
    responseDataFormat: {
      propDefinition: [
        servicenow,
        "responseDataFormat",
      ],
    },
    excludeReferenceLinks: {
      propDefinition: [
        servicenow,
        "excludeReferenceLinks",
      ],
    },
    responseFields: {
      propDefinition: [
        servicenow,
        "responseFields",
      ],
    },
    inputDisplayValue: {
      propDefinition: [
        servicenow,
        "inputDisplayValue",
      ],
    },
    responseView: {
      propDefinition: [
        servicenow,
        "responseView",
      ],
    },
  },
  async run({ $ }) {
    const response = await this.servicenow.createTableRecord({
      $,
      table: this.table,
      data: parseObject(this.recordData),
      params: {
        sysparm_display_value: this.responseDataFormat,
        sysparm_exclude_reference_link: this.excludeReferenceLinks,
        sysparm_fields: this.responseFields?.join?.() || this.responseFields,
        sysparm_input_display_value: this.inputDisplayValue,
        sysparm_view: this.responseView,
      },
    });

    $.export("$summary", `Successfully created record in table "${this.table}"`);

    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
ServiceNow	`servicenow`	`app`	This component uses the ServiceNow app.
Table	`table`	`string`	Select a value from the drop down menu.
Record Data	`recordData`	`object`	The data to create the record with, as key-value pairs (e.g. `{ "name": "John Doe", "email": "john.doe@example.com" }`)
Response Data Format	`responseDataFormat`	`string`	Select a value from the drop down menu:`{ "value": "true", "label": "Returns the display values for all fields" }{ "value": "false", "label": "Returns the actual values from the database" }{ "value": "all", "label": "Returns both actual and display values" }`
Exclude Reference Links	`excludeReferenceLinks`	`boolean`	If true, the response excludes Table API links for reference fields
Response Fields	`responseFields`	`string[]`	The fields to return in the response. By default, all fields are returned
Input Display Value	`inputDisplayValue`	`boolean`	If true, the input values are treated as display values (and are manipulated so they can be stored properly in the database)
Response View	`responseView`	`string`	Select a value from the drop down menu:`desktopmobileboth`

Action Authentication#

ServiceNow uses OAuth authentication. When you connect your ServiceNow account, Pipedream will open a popup window where you can sign into ServiceNow and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any ServiceNow API.

Pipedream requests the following authorization scopes when you connect your account: