Skip to main content
The Airtable integration allows Mary to receive work assignments directly from your Airtable bases. When records are assigned to Mary in Airtable, she automatically receives them and can start working. This integration connects your Airtable workflow with Mary’s AI capabilities, allowing you to assign tasks to Mary just like you would assign them to any team member.

What You’ll Need

Before you start:
  • Airtable account for Mary - Create a separate Airtable account that Mary will use to access your bases
  • allGood account - Access to Settings → Integrations
  • Airtable base - The base where you’ll assign work to Mary

What This Integration Does

This integration allows you to assign work to Mary directly from Airtable:
  1. You configure which Airtable tables Mary should monitor
  2. When you assign a record to Mary in Airtable, she automatically receives it
  3. Mary can read the record details, add comments, and access attachments
  4. You can track Mary’s progress by watching for her updates in Airtable
This lets you use Airtable as your task management system while Mary handles the work you assign to her.

IT Coordination Guide

Security & Account Setup Requirements

  • Create a dedicated Airtable user account for Mary with appropriate permissions
  • Use a monitored email address for the service account (not personal email)
  • Webhook configuration required for task collaboration notifications
  • Store credentials securely according to company policy

Step-by-Step Setup

1

Connect Mary's Airtable Account

Before you start: Make sure you’re signed into Airtable in your browser with Mary’s Airtable account. If you’re signed into a different Airtable account, sign out and sign in with Mary’s account first.
  1. Log into allGood with your own account
  2. Go to SettingsIntegrations
  3. Under Advanced, click on Airtable
  4. Click Link your Airtable account
An Airtable authorization window will pop up.
  1. Select the base(s) you want Mary to access (you can select multiple bases)
  2. Click Grant access
You’ll be redirected back to the Integrations page. Go back to the Airtable page under Advanced, and you’ll see “Connected” next to Mary’s Airtable email address.
2

Configure Your Table for Mary

Now tell Mary which table to watch and where to find important information in your records.Table_Configuration.png
  1. In the Table Configuration section, select your Base
  2. Select the Table where you’ll assign work to Mary
  3. Map these three fields (tell Mary where to find key information):
    • Name Field: Which field has the record’s name? (like “Task Name”)
    • Assignee Field: Which field shows who’s assigned? (like “Assigned To”)
    • Attachment Field: Which field has file attachments? (like “Attachments”)
  4. Select Watch Fields: Choose which field changes Mary should notice We recommend selecting only the Assignee field. This ensures Mary gets notified when work is assigned to her, but not for every other change to the record.
    • ✅ Mary gets notified when someone assigns the record
    • ❌ Mary ignores description changes
    • ❌ Mary ignores date changes
  5. Click Save Table Configuration
You’ll see an orange success message.
3

Create a Subscription

Once you’ve saved your table configuration, the “Create Subscription” section will appear.Create_Subscription.png
  1. Select your Base (same one as Step 2)
  2. Click Subscribe
You’ll see the subscription appear with a green “Active” status.Subscription_Active.pngImportant: You can only have one subscription per base. If you want to monitor multiple tables in the same base, just configure each table (Step 2) — they’ll all use the same subscription.
4

Test It Out

  1. Open your Airtable base
  2. Upload a file to a record’s attachment field (docx, csv, or excel file)
  3. Assign the record to Mary (set the assignee field to Mary)
  4. Mary will receive the assignment and start working on it

Advanced Configuration

Monitoring More Tables

To add another table in the same base:
  1. Go to Table Configuration
  2. Select the same base, different table
  3. Configure the fields and watch fields
  4. Click Save
  5. Scroll to Create Subscription
  6. Click on your subscription to expand it
  7. Click Recreate Subscription
You need to recreate the subscription so it includes the new table’s watch fields.

Changing Watch Fields

If you want to change watch fields for a table you already configured:
  1. Update the watch fields in Table Configuration
  2. Click Save
  3. Scroll to Create Subscription
  4. Click on your subscription to expand it
  5. Click Recreate Subscription
Recreate_Subscription.png Why recreate? Watch fields are set when the subscription is created. To change them, we have to delete the old subscription and create a new one with your updated settings.

Subscription Status

Click on a subscription to see:
  • ✅ Green “Active” = working
  • ⏰ Yellow “Expiring soon” = will auto-refresh
  • ❌ Red “Expired” = click Recreate
allGood automatically refreshes subscriptions every 5 days to keep them active.

Frequently Asked Questions

This integration lets you assign work to Mary directly from Airtable. When you assign a record to Mary in Airtable, she automatically receives it and can start working on it.Integration
Mary can:
  • Read records from tables you configure
  • Add comments to records when she completes work
  • Read file attachments from records
Mary cannot access:
  • Tables you don’t configure for her
  • Bases you don’t set up
You need to tell Mary which fields matter before she starts watching for changes. This way, Mary only pays attention to important changes (like when someone assigns a record to her) and ignores unimportant ones (like when someone changes a description).
No, only one subscription per base is allowed. allGood uses a single subscription to monitor all tables you configure in a base, so multiple subscriptions aren’t necessary.
  1. Go to Table Configuration
  2. Select your base and a new table
  3. Configure the field mappings and watch fields
  4. Save the configuration
  5. Go to Create Subscription section
  6. Expand your subscription and click “Recreate Subscription”
You need to recreate the subscription so it can include the new table’s watch fields.
You must recreate the subscription for changes to take effect:
  1. Update the watch fields or add new tables in Table Configuration
  2. Save the changes
  3. Go to Create Subscription section
  4. Expand your subscription and click “Recreate Subscription”
This is necessary because watch fields are set when the webhook is created. To update them, the webhook must be deleted and recreated with the new configuration.
You must configure three fields for each table:
  • Name Field: Identifies the record (e.g., “Task Name”)
  • Assignee Field: Shows who’s assigned
  • Attachment Field: Contains file attachments
Yes! Each table has its own configuration. For example, Table A might use “Task Name” as the name field while Table B uses “Project Title”. Configure each table independently based on its structure.
Airtable webhooks expire after 7 days if not refreshed. allGood automatically refreshes your webhooks before they expire to keep them active continuously.
Only changes to watch fields trigger notifications. We recommend watching just the Assignee field — this way Mary gets notified when work is assigned to her, but not for every other change to the record.
No. Airtable doesn’t currently support notifications for comment changes, so Mary won’t be notified when comments are added or updated — only when the watch fields you’ve configured are changed.
Notifications typically arrive within seconds of the Airtable change. Normal delays are under 10 seconds.
This can happen if the Airtable OAuth popup opens in a browser window where a different Airtable account is signed in (e.g., an incognito window or different browser profile).To fix this:
  1. In the browser window you’ll use for reconnection, go to airtable.com and confirm you’re signed into Mary’s Airtable account — sign out and back in if needed
  2. In allGood, go to SettingsIntegrationsAirtable
  3. Click Reconnect Airtable account and complete the authorization
  4. Verify the connected email matches Mary’s Airtable account

Troubleshooting

When you assign a record to Mary in Airtable, you should see a new worksheet start in allGood with a kickoff message. If that’s not happening, check:
  1. ✅ Is the subscription status “Active”?
  2. ✅ Did you change the Assignee field (the one you configured as the watch field)?
  3. ✅ Is the Assignee field mapped correctly in Table Configuration?
Common issues: Assignee field mapped to wrong column, subscription has expired, you changed a different field, or the OAuth connection is disconnected.
This means you haven’t configured any tables with watch fields yet.
  1. Go to Table Configuration
  2. Select a base and table
  3. Configure field names
  4. Select at least one watch field
  5. Click Save Table Configuration
  6. Try creating the subscription again
You can only have one subscription per base.Options:
  1. Use the existing subscription and configure more tables under it
  2. Delete the existing subscription and create a new one
  3. Recreate the existing subscription to update it
Your authorization may have expired or been revoked.
  1. Click “Reconnect Airtable account”
  2. Complete the OAuth flow again
  3. Your configurations will be restored
This may indicate Airtable API problems or OAuth token expiration.
  1. Manually recreate the subscription
  2. If problem persists, reconnect your Airtable account
  3. Contact support if issues continue
  • Green “Active”: Working correctly
  • Yellow “Expiring in X days”: Will be auto-refreshed soon
  • Red “Expired”: Needs manual recreation — click Recreate Subscription
Contact allGood support with a screenshot of the error, the base and table names, steps to reproduce, and subscription status.