Skip to main content

Overview

DirectoryEasy provides powerful integrations to enhance your directory with AI-powered content, automatic screenshots, real-time webhooks, data synchronization, and custom media storage.

AI Assistant Hub

The AI Assistant Hub lets you enhance your directory with AI-powered content generation. You can configure providers, select models, and manage your AI credits.

Free Trial Credits

Your free trial shows remaining AI generations—for example, 8 credits left—which use premium API keys without setup.

Configure AI Providers

You can connect multiple providers and set a default:
  • OpenAI
  • Anthropic
  • Google
GPT models like GPT-4o for versatile content generationUse OpenAI’s powerful language models for generating listing descriptions and content.

Setting Up AI Providers

1

Select Provider

Choose from OpenAI, Anthropic, or Google.
2

Enter API Key

Enter your API key for the selected provider.Security: Your API key is stored securely.
3

Choose Default Model

Select the default model that fits your content needs.
4

Save Configuration

Click Save Configuration to enable AI content generation across your directory.
Once configured, AI content generation will be available throughout your directory for automatic description writing and content creation.

Screenshot One Integration

The Screenshot One Integration lets your directory automatically capture high-quality screenshots of websites when users add new listings.

Current Status

Currently, the feature is inactive until you configure your Screenshot One API keys.

Optional Feature

This optional feature enhances the user experience by providing professional screenshots for listings.Your directory will function normally without this feature, but enabling it adds a polished, professional look to your listings.

Configuration

1

Enter Access Key

Enter your Screenshot One Access Key.
2

Enter Secret Key

Enter your Screenshot One Secret Key.
3

Enable Screenshot Capture

Toggle Enable Screenshot Capture.
4

Save Configuration

Click Save Configuration to apply the settings.
Once configured, screenshots are captured automatically for listings with websites.

Webhooks

The Webhooks section lets you receive real-time notifications when events happen in your directory.

Creating a Webhook

1

Click Create Webhook

Start creating a new webhook integration.
2

Fill in Details

Enter the webhook configuration details.
3

Select Events

Choose which events you want to receive notifications for.
4

Configure Security

Set up webhook secret and advanced settings.
5

Create Webhook

Click Create Webhook to start receiving real-time notifications.

Webhook Configuration

A descriptive name for your webhook.This helps you identify different webhooks in your dashboard.
Where the webhook requests will be sent.Requirements: Must be a valid HTTPS URL that can receive POST requests.
Additional context about this webhook.Use this to document the purpose or integration details.
Select the events you want to receive notifications for:Listing Events:
  • listing.created - When a new listing is created
  • listing.published - When a listing is published
User Events:
  • user.signup - When a new user signs up
Payment Events:
  • payment.succeeded - When a payment is successful
Set a Webhook Secret to verify requests from DirectoryEasy.This secret is used to generate signatures for authentication.
Configure additional webhook behavior:
  • Timeout: How long to wait for a response
  • Retry Attempts: Number of retry attempts on failure
  • Retry Delay: Delay between retry attempts

How Webhooks Work

Event Notifications

When an event occurs, DirectoryEasy sends a POST request to your endpoint with:JSON Payload: Contains event details and dataRequest Signature: Each request includes a signature (X-DirectoryEasy-Signature) to verify authenticityYou can use this signature to confirm the request came from DirectoryEasy.

Best Practices

Verify the signature of incoming requests using your webhook secret.This ensures the request is legitimate and from DirectoryEasy.
Implement idempotency to handle duplicates.Process each webhook event only once, even if received multiple times.
Respond quickly (within 5 seconds).Return a 200 OK response as soon as possible to acknowledge receipt.
Use HTTPS for your endpoint.Secure endpoints protect your data and are required for webhooks.

Google Sheets Integration (Beta)

The Google Sheets Integration (Beta) lets you sync your directory listings with Google Sheets for easy data management.

Connection Status

Once connected, you can see:

Google Account

The connected Google account

Status

Connection status (active/inactive)

Last Sync

When data was last synchronized

Auto Sync

Whether automatic sync is enabled
You can also open the connected spreadsheet directly from the interface.

Manual Sync

Use Manual Sync to update data on demand:
  • Push to Google Sheets
  • Pull from Google Sheets
Send your directory listings to Google Sheets.Updates the spreadsheet with current listing data from your directory.

Sync Settings

Configure how data synchronization works:
Configure the sync direction:One-way: Data flows in only one direction (Push only or Pull only)Two-way: Data syncs in both directions automatically
Set Auto Sync to update data automatically every 2 hours.When enabled, your directory and spreadsheet stay in sync without manual intervention.

Danger Zone

Disconnect Google SheetsThe Danger Zone allows you to disconnect Google Sheets integration.Important: This action is irreversible. Once disconnected, you’ll need to reconnect and reconfigure the integration.

Media Upload Integration

Configure your media upload service for images and files in your directory.

Upload Service Options

  • Default Service
  • Custom S3
  • Custom Cloudinary
Use DirectoryEasy’s default upload service.Features:
  • No configuration required
  • Works perfectly out of the box
  • Managed by DirectoryEasy
The default service works perfectly even if you choose not to set anything up.
This feature is completely optional. The default service works perfectly even if you choose not to set anything up.

Current Configuration Status

When configured, you can see:
  • Provider Status: Default or Custom (S3/Cloudinary)
  • Upload Limit: Unlimited (for custom) or plan-based (for default)
  • Size Limit: Maximum file size per upload (e.g., 5 megabytes)
  • File Count: Maximum number of files (e.g., 10 files)

S3 Configuration

1

Choose S3 Provider

Select S3 as your upload service in the configuration panel.
2

Enter Access Keys

Provide your AWS access credentials:
  • Access Key
  • Secret Access Key
3

Set Region

Enter your AWS region (e.g., eu-north-1).
4

Enter Bucket Name

Provide your S3 bucket name (e.g., directoryeasy-nocode).
5

CloudFront URL (Optional)

Add your CloudFront URL if you use a CDN.If left empty: Your directory will use the direct S3 URL for images.
6

Set Limits

Control the size and count limits:
  • Maximum file size per upload
  • Maximum number of files per upload
7

Save Configuration

Click Save Configuration to apply your S3 settings.

Updating Configuration

Update Anytime

You can update your keys at any time by entering new values.Simply change the configuration values and save to apply the new settings.

S3 Configuration Example

Provider: S3
Region: eu-north-1
Bucket Name: directoryeasy-nocode
CloudFront URL: (optional)
Size Limit: 5 MB per file
File Count: 10 files maximum
Status: Custom (Unlimited uploads)

Cloudinary Configuration

1

Choose Cloudinary Provider

Select Cloudinary as your upload service.
2

Enter Credentials

Provide your Cloudinary account credentials.
3

Configure Limits

Set size and count limits for uploads.
4

Save Configuration

Apply your Cloudinary settings.

Integration Benefits

AI Content Generation

Automatically generate high-quality descriptions for listings

Professional Screenshots

Capture website screenshots automatically for visual appeal

Real-Time Webhooks

Get instant notifications for important directory events

Google Sheets Sync

Manage listings easily with familiar spreadsheet interface

Custom Media Storage

Unlimited uploads with your own S3 or Cloudinary account

Full Control

Configure each integration to match your specific needs

Next Steps