Create Objects with Algolia API on New, Modified or Deleted Records from Airtable API

Pipedream makes it easy to connect APIs for Algolia, Airtable and 2,700+ other apps remarkably fast.

Trigger workflow on

New, Modified or Deleted Records from the Airtable API

Next, do this

Create Objects with the Algolia 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 Airtable trigger and Algolia action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New, Modified or Deleted Records trigger
1. Connect your Airtable account
2. Configure timer
3. Select a Base
4. Optional- Configure Filter by Formula
5. Select a Table
6. Optional- Configure Return Fields By ID
Configure the Create Objects action
1. Connect your Algolia account
2. Select a Index Name
3. Configure Objects
4. Optional- Configure Auto Generate Object ID If Not Present
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#

New, Modified or Deleted Records on Airtable

Description:Emit new event each time a record is added, updated, or deleted in an Airtable table. Supports tables up to 10,000 records

Version:0.0.12

Key:airtable_oauth-new-modified-or-deleted-records

View on GitHub

Airtable Overview#

Airtable (OAuth) API on Pipedream allows you to manipulate and leverage your Airtable data in a myriad of powerful ways. Sync data between Airtable and other apps, trigger workflows on updates, or process bulk data operations asynchronously. By using Airtable's structured databases with Pipedream's serverless platform, you can craft custom automation solutions, integrate with other services seamlessly, and streamline complex data processes.

Trigger Code#

import base from "../common/common.mjs";
import moment from "moment";

export default {
  ...base,
  name: "New, Modified or Deleted Records",
  description: "Emit new event each time a record is added, updated, or deleted in an Airtable table. Supports tables up to 10,000 records",
  key: "airtable_oauth-new-modified-or-deleted-records",
  version: "0.0.12",
  type: "source",
  dedupe: "unique",
  props: {
    ...base.props,
    tableId: {
      propDefinition: [
        base.props.airtable,
        "tableId",
        ({ baseId }) => ({
          baseId,
        }),
      ],
      description: "The table ID to watch for changes.",
    },
    returnFieldsByFieldId: {
      propDefinition: [
        base.props.airtable,
        "returnFieldsByFieldId",
      ],
    },
  },
  methods: {
    ...base.methods,
    _getPrevAllRecordIds() {
      return this.db.get("prevAllRecordIds");
    },
    _setPrevAllRecordIds(prevAllRecordIds) {
      this.db.set("prevAllRecordIds", prevAllRecordIds);
    },
  },
  async run(event) {
    const {
      baseId,
      tableId,
      viewId,
    } = this;

    const metadata = {
      baseId,
      tableId,
      viewId,
    };

    const prevAllRecordIds = this._getPrevAllRecordIds();

    const lastTimestamp = this._getLastTimestamp();
    const params = this.getListRecordsParams({
      formula: `LAST_MODIFIED_TIME() > "${lastTimestamp}"`,
    });

    const records = await this.airtable.listRecords({
      baseId,
      tableId,
      params,
    });

    let newRecordsCount = 0,
      modifiedRecordsCount = 0,
      deletedRecordsCount = 0;

    if (records) {
      for (const record of records) {
        if (!lastTimestamp || moment(record.createdTime) > moment(lastTimestamp)) {;
          this.$emit({
            ...record,
            type: "new_record",
            metadata,
          }, {
            id: record.id,
            summary: `New record: ${record.id}`,
            ts: moment(record.createdTime).valueOf(),
          });
          newRecordsCount++;

        } else {
          const ts = Date.now();
          const id = `${record.id}-${ts}`;
          this.$emit({
            ...record,
            type: "record_modified",
            metadata,
          }, {
            id,
            summary: `Record modified: ${record.id}`,
            ts,
          });
          modifiedRecordsCount++;
        }
      }
    }

    delete params.filterByFormula;

    const data = await this.airtable.listRecords({
      baseId,
      tableId,
      params,
    });

    const allRecordIds = data.map((record) => record.id);

    if (prevAllRecordIds) {
      const currentRecordIdSet = new Set(allRecordIds);
      const deletedRecordIds =
        prevAllRecordIds.filter((prevRecord) => !currentRecordIdSet.has(prevRecord));

      for (const recordID of deletedRecordIds) {
        const ts = Date.now();
        const id = `${recordID}-${ts}`;
        this.$emit({
          id: recordID,
          metadata,
          type: "record_deleted",
        }, {
          id,
          summary: `Record deleted: ${recordID}`,
          ts,
        });
        deletedRecordsCount++;
      }
    }

    console.log(
      `Emitted ${newRecordsCount} new records(s) and ${modifiedRecordsCount} modified record(s) and ${deletedRecordsCount} deleted records.`,
    );
    this._setPrevAllRecordIds(allRecordIds);

    // We keep track of the timestamp of the current invocation
    this.updateLastTimestamp(event);
  },
};

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
Airtable	`airtable`	`app`	This component uses the Airtable app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Base	`baseId`	`string`	Select a value from the drop down menu.
Filter by Formula	`filterByFormula`	`string`	Optionally provide a formula (see info on the documentation) used to filter records. The formula will be evaluated for each record, and if the result is not `0`, `false`, `""`, `NaN`, `[]`, or `#Error!` the record will be included in the response. For example, to only include records where `Name` isn't empty, use `NOT({Name} = '')`.
Table	`tableId`	`string`	Select a value from the drop down menu.
Return Fields By ID	`returnFieldsByFieldId`	`boolean`	If set to `true`, the returned field objects will have the field ID as the key, instead of the field name.

Trigger Authentication#

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

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

data.records:readdata.records:writedata.recordComments:readdata.recordComments:writeschema.bases:readschema.bases:writewebhook:manageuser.email:read

About Airtable#

Airtable is a low-code platform to build next-gen apps. Move beyond rigid tools, operationalize your critical data, and reimagine workflows with AI.

Action#

Create Objects on Algolia

Description:Adds an array of JavaScript objects to the given index. [See docs here](https://www.algolia.com/doc/api-reference/api-methods/save-objects/)

Version:0.0.3

Key:algolia-create-objects

View on GitHub

Algolia Overview#

Algolia is a powerful search-as-a-service platform that makes it easy to deliver fast, relevant search experiences to users. The Algolia API allows developers to programmatically manage search indices, perform searches, and capture insights about search activity. With Pipedream, you can harness this API to automate and integrate Algolia's capabilities with other apps, creating efficient workflows that enhance search functionalities and user engagement. You can sync data across platforms, automate content indexing, and trigger actions based on search patterns or user behaviors.

Action Code#

import algolia from "../../algolia.app.mjs";

export default {
  key: "algolia-create-objects",
  name: "Create Objects",
  description: "Adds an array of JavaScript objects to the given index. [See docs here](https://www.algolia.com/doc/api-reference/api-methods/save-objects/)",
  version: "0.0.3",
  type: "action",
  props: {
    algolia,
    indexName: {
      propDefinition: [
        algolia,
        "indexName",
      ],
    },
    objects: {
      label: "Objects",
      description: "An array of JavaScript objects, each corresponding to a new object in your search index. It's recommended you create this array of objects in a prior code step, then select expression mode and enter a variable reference to that array here",
      type: "string[]",
    },
    autoGenerateObjectIDIfNotExist: {
      type: "boolean",
      label: "Auto Generate Object ID If Not Present",
      description: "If an objectID property is not present on objects, automatically assign on. Defaults to true",
      optional: true,
      default: true,
    },
  },
  methods: {
    parseObject(object) {
      return (typeof object === "object")
        ? object
        : JSON.parse(object);
    },
  },
  async run({ $ }) {
    const parsedObjects = this.objects.length
      ? this.objects.map((object) => this.parseObject(object))
      : this.parseObject(this.objects);

    const response = await this.algolia.createObjects({
      indexName: this.indexName,
      objects: parsedObjects,
      options: {
        autoGenerateObjectIDIfNotExist: this.autoGenerateObjectIDIfNotExist,
      },
    });

    $.export("$summary", "Successfully created objects");

    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
Algolia	`algolia`	`app`	This component uses the Algolia app.
Index Name	`indexName`	`string`	Select a value from the drop down menu.
Objects	`objects`	`string[]`	An array of JavaScript objects, each corresponding to a new object in your search index. It's recommended you create this array of objects in a prior code step, then select expression mode and enter a variable reference to that array here
Auto Generate Object ID If Not Present	`autoGenerateObjectIDIfNotExist`	`boolean`	If an objectID property is not present on objects, automatically assign on. Defaults to true

Action Authentication#

Algolia uses API keys for authentication. When you connect your Algolia account, Pipedream securely stores the keys so you can easily authenticate to Algolia APIs in both code and no-code steps.

In your Algolia Dashboard, select the API Keys section. Here you'll find your Application ID and API Keys. You can use either your Admin API Key or create another API key with permissions scoped to a specific index / operations (recommended).

Once done, enter both values below.

Create Objects with Algolia API on New, Modified or Deleted Records from Airtable API

Pipedream makes it easy to connect APIs for Algolia, Airtable and 2,700+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,700+apps by most popular

1
-
24
of
2,700+
apps by most popular