This ensures your stores appear correctly on the map—even when coordinates are missing from the source data.

When Do You Need This Feature?

You should enable coordinate fetching if:

• Your external API does not return latitude and longitude
• Your store records include address fields like:
  • Street
  • City
  • State
  • Postal Code
  • Country

Agile Sync uses these fields to generate accurate coordinates via Google Geocoding.

How Agile Sync Fetches Coordinates

When coordinates are missing:

1. Agile Sync sends the full address to Google Geocoding API
2. Google returns the latitude and longitude
3. The addon automatically saves those values with the store record

No manual intervention is required once configured correctly.

Required Configuration (Very Important)

Before enabling this feature, make sure both requirements below are met.

Google Server API Key Must Be Properly Configured

Your Google Server API Key must:

• Be enabled and active
• Have NO HTTP referrer restrictions
• Have Geocoding API enabled

If your key is restricted or misconfigured, coordinates will not be fetched.

Follow this step-by-step guide to fix it:
https://agilestorelocator.com/wiki/google-server-api-key-troubleshooting/

Do NOT Map Latitude & Longitude Fields

If your external API does not provide coordinates:

• Do not map lat or lng fields in the Agile Sync field mapping
• Leave latitude and longitude unmapped

This allows Agile Sync to detect missing coordinates and fetch them automatically.

Important Note for Existing Sync Jobs

If you already have an existing Agile Sync job, coordinate fetching may not run due to timestamp validation.

Why This Happens

If the “Last Modified” field is mapped:

• Agile Sync only updates records when the external API provides a newer timestamp
• Existing records without updated timestamps will not refresh coordinates

Recommended Solution (Clean Reset)

To ensure coordinates are fetched correctly:

1. Go to Agile Store Locator → Import / Export
2. Delete all existing stores
3. Delete the existing Agile Sync job
4. Create a new Agile Sync job
5. Ensure:
   • Latitude & longitude are not mapped
   • Google Server API key is properly configured
6. Run the new sync

This forces all records to be reprocessed and coordinates to be generated correctly.

• Transform API responses
• Modify endpoints and headers
• Handle pagination
• Map external data into the Agile Store Locator format

Use these filters to customize your synchronization logic when working with platforms like Salesforce, Google Sheets, and REST APIs.

Filters

1. asl_sync_data_row_mapping

Transform each data record before it’s saved into the store database.

add_filter('asl_sync_data_row_mapping', function ($store_inst, $data_row) {
    // Convert "yes" to true boolean
    if (isset($store_inst['is_disabled'])) {
        $store_inst['is_disabled'] = (strtolower($store_inst['is_disabled']) === 'yes') ? 1 : 0;
    }

    // Example: build Facebook URL
    if (isset($data_row['facebookVanityUrl'])) {
        $store_inst['custom-facebook_url'] = "https://www.facebook.com/" . esc_attr($data_row['facebookVanityUrl']) . "/";
    }

    return $store_inst;
}, 10, 2);

Params:

• $store_inst: The processed store data array.
• $data_row: The original raw API data row.

Set the marker_id via hook.

add_filter('asl_sync_data_row_mapping', function ($store_inst, $data_row) {
    
		$store_inst['marker_id'] = 153;

    return $store_inst;
}, 10, 2);

2. asl_sync_prepare_endpoint

Customize or append query parameters to the API endpoint before the request is sent.

add_filter('asl_sync_prepare_endpoint', function ($endpoint_url) {
    $endpoint_url .= '&filter={"meta.folderId":{"$eq":"112810"}}';
    return $endpoint_url;
});

3. asl_sync_logo_url

Update or override the logo URL used during the sync process.

add_filter('asl_sync_logo_url', function ($logo_url, $handler) {
    return str_replace('http://', 'https://', $logo_url);
}, 10, 2);

4. asl_sync_endpoint

Modify the final API endpoint using full sync config context.

add_filter('asl_sync_endpoint', function ($endpoint, $config) {
    return $endpoint . '?apikey=' . $config['sync_key'];
}, 10, 2);

5. asl_sync_request_data

Alter the request payload (body) before it is sent to the API.

add_filter('asl_sync_request_data', function ($data, $config) {
    $data['region'] = 'Middle East';
    return $data;
}, 10, 2);

6. asl_sync_request_headers

Customize or add headers to the outgoing API request.

add_filter('asl_sync_request_headers', function ($headers, $config) {
    $headers['Authorization'] = 'Bearer ' . $config['bearer_token'];
    return $headers;
}, 10, 2);

7. asl_sync_api_request_params

Modify the full set of parameters used in the request.

add_filter('asl_sync_api_request_params', function ($params) {
    $params['timeout'] = 30;
    return $params;
});

8. asl_sync_raw_response

Filter or log the raw response before it’s parsed or mapped.

add_filter('asl_sync_raw_response', function ($response, $params) {
    error_log(print_r($response, true));
    return $response;
}, 10, 2);

9. asl_sync_request_pagination

Add logic to recursively fetch all pages from a paginated API.

add_filter('asl_sync_request_pagination', function ($responseData, $apiClient, $params) {
    $all = $responseData['response']['entities'];
    $max = 10;

    while (isset($responseData['response']['pageToken']) && $max-- > 0) {
        $params['endpoint'] .= '&pageToken=' . $responseData['response']['pageToken'];
        $responseData = $apiClient->makeApiRequest($params);

        if (isset($responseData['response']['entities'])) {
            $all = array_merge($all, $responseData['response']['entities']);
        }
    }

    $responseData['response']['entities'] = $all;
    return $responseData;
}, 10, 3);

10. asl_sync_completed_event (Action)

Run custom logic after a sync completes.

add_action('asl_sync_completed_event', function ($sync_key, $settings) {
    // Send admin notification or log sync summary
});

11. asl_sync_skip_data_row

To create a criteria to skip certain rows from import based on condition.

add_filter('asl_sync_skip_data_row', function ($should_skip, $row, $sync_id) {

	// Skip if the Sync_To_Store_Listing__c flag is missing or not true
	if (!isset($row['Sync_To_Store_Listing__c']) || strtolower($row['Sync_To_Store_Listing__c']) !== 'true') {
			return true; // Skip this record
	}

	return false; // Sync this record
}, 10, 3);

12. asl_sync_validate_timestamp (New in v1.0.6)

Control whether a data row should be blocked by timestamp validation during sync. Returning false from this filter bypasses the “updated_on vs last_exec_time_stamp” check so the row will be processed even if its timestamp is not newer.

Example: One-time backfill (bypass only once)

Use a static flag to ensure the bypass happens once per run (recommended to avoid reprocessing every row repeatedly).

/**
 * One-time bypass to force a backfill on the first row only.
 * Version: v1.0.6+
 */
function asl_force_sync_timestamp_bypass_once( $validate, $row, $sync_id, $row_ts, $last_ts ) {
 
    return false; // bypass timestamp validation ONCE
}
add_filter( 'asl_sync_validate_timestamp', 'asl_force_sync_timestamp_bypass_once', 10, 5 );

Developer Notes

• Use filters inside a custom plugin or your theme’s functions.php.
• Always validate and sanitize external data before saving.
• Test filters with a manual sync run using the “Run Sync Now” button.

Need Help?

For custom integration support or additional hooks, reach out at support@agilelogix.com

This guide covers how to set up your Salesforce connection, map objects and fields, and run successful sync operations using the Agile Sync Addon.

Prerequisites

Before starting:

• You must have admin access to both WordPress and Salesforce.
• Agile Sync Addon must be installed and activated.
• API access must be enabled in your Salesforce plan.

Create a Connected App in Salesforce

1. Log in to your Salesforce account.
2. Go to Setup > App Manager.
3. Click New Connected App.
4. Fill out the basic app details (App Name, Contact Email).
5. Enable OAuth Settings:
   • Check Enable OAuth Settings.
   • Add a temporary Callback URL (e.g. https://localhost/callback).
   • Add OAuth scopes:
     • Access and manage your data (api)
     • Perform requests on your behalf (refresh_token, offline_access)
6. Click Save and wait 5–10 minutes for the app to activate.
7. Open the app, click Manage Consumer Details, and verify your identity.
8. Copy your Consumer Key and Consumer Secret.

Create a New Sync Job in WordPress

1. Go to Agile Store Locator > Agile Sync.
2. Click Add New Job.
3. Select Salesforce as the platform.
4. Enter:
   • Client ID (Consumer Key)
   • Client Secret
   • Username
   • Password (+ Security Token) or whitelist your IP in Salesforce.
5. Click Test Connection to verify.

Configure IP Whitelist (Optional Alternative to Security Token)

1. In Salesforce Setup, go to Profiles > choose your user profile (e.g., System Administrator).
2. Click Login IP Ranges > New.
3. Add a wide IP range (e.g. 0.0.0.0 to 255.255.255.255) for testing.
4. Save changes.

Enable Username-Password Flow in Salesforce

If your test connection fails with a “Password Flow Disabled” error:

1. Go to Setup > OAuth and OpenID Connect Settings.
2. Enable Username-Password Flow.

Map Standard Salesforce Fields

1. Click Start Mapping from your sync job screen.
2. Select the Salesforce object (e.g. Account).
3. Map required fields:
   • ID → Plugin’s API Item ID
   • LastModifiedDate → Update Timestamp
   • Name → Store Title
   • Latitude / Longitude → Coordinates
   • Address Fields → Address lines
   • Description → Store Description
4. Click Save Mapping.
5. Enable notifications if desired (sends an email after every sync).
6. Enable “Delete Orphan Records” to remove stores not present in Salesforce.

Map Custom Salesforce Fields (Optional)

Example: Map “Categories” and “Disabled” Fields

1. In Salesforce, go to Account > Fields & Relationships.
2. Create:
   • A Picklist field named Categories
   • A Checkbox field named Disabled
3. Update some test records:
   • Assign category values like Distributor, Favorite
   • Check the Disabled box for inactive entries
4. Back in Agile Sync:
   • Click Get Objects to refresh schema.
   • Re-select Account.
   • Map Categories to store categories.
   • Map Disabled to control store visibility.
5. Click Save Mapping.

Run the Sync

1. From the sync job, click Run Sync Now.
2. After execution:
   • Navigate to Managed Stores.
   • Verify synced fields like categories and status.
   • Disabled stores will be hidden based on your field mapping.

Troubleshooting Tips

• If fields don’t appear, re-fetch objects using Get Objects.
• If sync fails, check:
  • API credentials
  • IP whitelisting
  • Username-Password Flow
  • Correct field mappings

Video Tutorial

Add a Clause in the Salesforce SOQL Query

If you want to sync only specific Salesforce records (for example, accounts that belong to certain account groups), you can use the following filters to control the SOQL query that Agile Sync Addon sends to Salesforce.

Add this code to your theme’s functions.php file or a custom plugin:

/**
 * Change the LIMIT of the Salesforce query
 * Return a number to set LIMIT, or null to remove it.
 */
add_filter('asl_sync_salesforce_limit', function($limit) {
    return 500; // or return null to remove LIMIT
}, 10, 1);

/**
 * Add a WHERE clause to the Salesforce SOQL query
 */
add_filter('asl_sync_salesforce_soql', function ($soql, $config, $fields, $object, $limit) {

    //  Custom WHERE clause
    $where = "WHERE Account_Group__c = 'Black Master Dealer' "
           . "OR Account_Group__c = 'Gold Master Dealer' "
           . "OR Account_Group__c = 'Master Dealer'";

    //  Apply LIMIT if it is set
    $limit_clause = ($limit !== null && $limit !== '') ? " LIMIT {$limit}" : '';

    //  Build and return the final SOQL query
    return "SELECT " . implode(',', $fields) . " FROM {$object} {$where}{$limit_clause}";

}, 10, 5);

Need Help?

If you encounter issues, contact our support team at support@agilelogix.com with:

• Your sync job settings
• The object name and field mappings
• A screenshot of the error (if any)

Managing store data across multiple platforms can be a slow, error-prone process, especially when you’re dealing with spreadsheets, CRM systems, or custom APIs.

Agile Sync eliminates this problem by providing a unified, real-time data synchronization solution built exclusively for the Agile Store Locator plugin.

What Is Agile Sync?

Agile Sync is a premium add-on for Agile Store Locator that connects your WordPress site to external data sources like Google Sheets, Smartsheet, Salesforce, or any REST API. 

Agile Sync allows you to automate store updates, map custom fields, and schedule data synchronization jobs without needing to touch a single line of code.

Whether you’re managing 10 or 1,000 store locations, Agile Sync ensures your data is accurate, up to date, and synced automatically across platforms.

Key Benefits

• Save Time: Eliminate repetitive data entry and reduce manual errors
  
• Real-Time Synchronization: Ensure your store information is always accurate
  
• Multi-Platform Ready: Synchronize with multiple APIs simultaneously
  
• Custom Field Mapping: Tailor the synchronization process to your store’s data structure
  
• Secure & Scalable: Built-in monitoring, scheduling, and password-protected API endpoints
  
• Easy Setup: Configure synchronization jobs directly from the WordPress admin dashboard
  

Key Features of Agile Sync

Powerful tools to automate and control your store data

Agile Sync comes packed with smart, time-saving features designed to simplify complex data flows across platforms.

Whether you’re syncing with cloud spreadsheets or enterprise-level APIs, these features help you manage your store data with confidence and flexibility.

1- Multi-API Synchronization

Connect with multiple REST API sources such as Google Sheets, Smartsheet, Salesforce, or any compatible third-party platform.

2- Real-Time Data Sync

Synchronize your store locations instantly or on a schedule—hourly, daily, or weekly—ensuring your data remains current at all times.

3- Field-to-Field Mapping

Map source fields (e.g., store_name, lat, lng) directly to Agile Store Locator’s fields with an intuitive visual interface.

4- Secure REST API Access

Expose your store data with a password-protected public API endpoint; ideal for connecting with custom apps or external tools.

5- Custom Synchronization Rules

Define exactly how your data should behave during sync: update only if changed, skip empty fields, or override existing data.

6- Continuous Monitoring

Agile Sync keeps an eye on your synchronization jobs 24/7, alerting you to any issues and maintaining data integrity across all endpoints.

7- Email Synchronization Notifications

Receive automatic email reports after every sync, see how many records were added, updated, skipped, or failed.

8- Import Store Logos

Synchronize store logos from your external source to visually enrich your store listings in Agile Store Locator.

9- Support for Custom Fields

Preserve and synchronize additional metadata, including operating hours, services, custom tags, and more using Agile Store Locator’s flexible field system.

How Agile Sync Works

From external data to perfectly synced store locations, all in a few clicks

Agile Sync is designed to be user-friendly, fast, and powerful. You don’t need technical expertise to keep your store data clean and consistent.

Here’s how it works:

1. Create a Sync Job
   Log into WordPress and access Agile Sync from the Agile Store Locator menu. Click “+ New Sync Job” to get started.
   
   
2. Choose a Platform
   Select from supported platforms like Google Sheets, Smartsheet, or any custom REST API.
   
   
3. Enter API Details
   Input the required fields such as API Key, Sheet ID, endpoint URL, authentication token, etc. — based on your selected platform.
   
4. Map Your Fields
   Use the visual field-mapping interface to match external fields (like location_name, lat, store_email) to Agile Store Locator fields.
   
   
5. Set Rules, Frequency and Email Notifications
   Customize how your data behaves during sync, and choose whether the synchronization should run hourly, daily, weekly, or on demand. Futhermore, enable or disable email notifications for your synchronization jobs.
   
   
6. Run or Schedule Synchronizations
   Trigger a manual synchronization by pressing the “Execute” button to test the sync job or let Agile Sync handle updates automatically in the background.
   
   
7. Monitor & Review
   View synchronization results on Agile Store Locator and receive detailed email reports after every job, including record status and any errors.
   

Platform Integrations

Connect to your favorite platforms in just minutes

Agile Sync supports a growing list of integrations with popular data platforms and REST-based services. Follow the guides below to get started with each:

• Google Sheets Integration
  
• Smartsheet Integration
  
• Salesforce Integration
  
• REST API Integration → (Guide Coming Soon)
  

Each guide includes a step-by-step tutorial, tips for field mapping, and best practices for maintaining clean data.

Why Choose Agile Sync?

The smarter way to keep your store data consistent and automated

Agile Sync isn’t just another plugin, it’s a powerful operations tool for growing businesses that manage store locations across multiple platforms. 

If you’re tired of manually updating records, chasing down errors, or struggling with mismatched data, Agile Sync was built for you.

Whether you’re syncing from spreadsheets, CRMs, or custom apps, Agile Sync gives you:

•  Real-time data accuracy
  
•  Multi-platform integration
  
• Transparent email reporting
  
• Secure API access
  
•  Full field mapping with custom fields
  
•  Seamless compatibility with Agile Store Locator
  

By automating store data synchronization, you save hours of manual work, reduce the risk of errors, and ensure your locator always reflects the latest information.

Ready to Sync Smarter?

Install Agile Sync and experience the benefits of effortless data control across your entire store locator system.

Get Agile Sync Now

For any questions, issues, or concerns, please reach us at the following email address: support@agilelogix.com

By connecting Smartsheet to Agile Sync, you can create real-time sync jobs that automatically update store records in Agile Store Locator with precision and full field mapping.

Requirements for Syncing with Smartsheet

To successfully connect Agile Sync with Smartsheet, ensure the following elements are ready:

1- Sheet ID

Each Smartsheet has a unique Sheet ID, which is required to pull the correct data.

To find it:
Log in to your Smartsheet dashboard → Open your sheet → Copy the last portion of the URL after /sheets/.

2- Smartsheet Access Token

To authorize Agile Sync to access your data, you must generate a valid API token from your Smartsheet account.

How to Get Your Smartsheet Access Token

1. Log in to your Smartsheet account.
   
2. Click on the “More” button (bottom left corner) → Account →   Apps & Integrations.
   
   
3. Click API Access.
   
4. Generate a new Access Token by pressing the “Generate new access token” button.
   
   
5. Copy this key and store it securely; you’ll paste it into Agile Sync’s platform configuration.
   

This token acts as your authentication. Do not share it publicly.

API Access & Permissions

Ensure that the Smartsheet file is accessible by the account that generated the API token.

If your sheet is restricted, Agile Sync will not be able to retrieve the data.

How to Create Your First Sync Job with Smartsheet

Once your Smartsheet credentials are ready, follow these steps to create a sync job inside Agile Sync that will pull store data directly into Agile Store Locator.

 Step-by-Step Instructions

1. Log in to WordPress
   Access your WordPress admin dashboard with appropriate permissions.
   
2. Navigate to Agile Sync
   In the sidebar, click Agile Store Locator → Agile Sync.
   
3. Click “+ New Sync Job”
   This will launch the sync setup wizard.
   
   
4. Name Your Sync Job
   Use a descriptive name like Smartsheet Store Import.
   
5. Select Platform: Smartsheet
   Choose Smartsheet from the list of available platforms.
   
   
6. Enter Required Credentials
   
   • Access Token
   • Sheet ID (from the sheet URL)
     
7. Click “Start Mapping”
   This opens the Field Mapping Interface, where you match your sheet columns to store fields.

Field Mapping

Use the drag-and-drop interface to map each store field (e.g., store_title, lat, lng, email) to the appropriate column in your Smartsheet file.

Special Note #1:
Make sure the api_item_id field is mapped and uniquely identifies each record in your Smartsheet. This ensures that Agile Sync can match and update stores accurately without duplication.

Special Note #2:
If your sheet contains a field like updated_on, map it to represent the record’s last modified date. Agile Sync will then only update records if their last updated timestamp is newer than the previous sync, making the process more efficient.

8. Click “Save Mapping”
   Once all fields are correctly mapped, save your configuration.

Set Frequency and Finalize

9. Set Sync Frequency
   Choose how often Agile Sync should run this job, hourly, daily, weekly, or manually.
   
10. Enable or Disable the Sync Job
    Toggle the switch based on whether you want the sync job to go live right away.
    
11. Enable Email Notifications
    Turn on email alerts to receive a summary every time the job runs, including records added, updated, or skipped.
    
    
12. Click “Finish”
    Your Smartsheet sync job is now created and ready to run.

How to Manually Trigger and Monitor a Smartsheet Sync Job

Once your sync job is configured and saved, you may want to test or manually trigger the sync to ensure everything is working correctly before relying on scheduled runs.

Manually Running the Sync Job

1. Go to Agile Sync Dashboard
   In your WordPress admin panel, navigate to Agile Store Locator → Agile Sync.
   
2. Find the Smartsheet Sync Job
   Locate the sync job you created, it will be listed by the name you assigned (e.g., Smartsheet Store Import).
   
3. Click “Execute”
   Use the Execute button next to the job to immediately start the data synchronization process.
   
   
4. View Progress or Status Messages
   Agile Sync will display a notification once the sync completes.

Verifying the Imported Data

After the sync is complete:

• Go to Agile Store Locator → Manage Stores
  
• Review the new or updated store listings
  
• Confirm that field mappings (like address, contact, coordinates) have been applied correctly
  

Check Email Notifications (If Enabled)

If you enabled email alerts, you’ll receive a detailed sync summary. This includes:

• Total records processed
  
• Records added or updated
  
• Any skipped records and reasons
  
• Timestamp of the last sync

For any questions, issues, or concerns, please reach us at the following email address: support@agilelogix.com

Using Agile Sync, you can connect a Google Sheet as your data source and configure sync jobs that pull store information directly into Agile Store Locator with custom field mapping and scheduling options.

Requirements for Syncing with Google Sheets

To successfully integrate Agile Sync with Google Sheets, you’ll need the following:

1- Sheet Name

This refers to the tab name inside your Google Sheet file.

Example: If your tab is labeled “Main Stores”, enter “Main Stores” in the sync configuration.

2- Sheet ID

You can find the Sheet ID in your browser’s address bar. It’s the long string between /d/ and /edit in the sheet’s URL.

Example:
For a Sheet with the below URL https://docs.google.com/spreadsheets/d/1A2bC3dEfGHiJKlmNOPqrSTUVwxYZ/edit

 The Sheet ID is:
1A2bC3dEfGHiJKlmNOPqrSTUVwxYZ

3-  Google API Key

You’ll need a valid API Key from your Google Cloud Console. This key allows Agile Sync to securely access your Google Sheet.

How to Get Your Google API Key:

1. Go to the Google Cloud Console.
   
2. Create a new project or select an existing one.
   
3. Navigate to APIs & Services → Credentials.
   
4. Click Create Credentials → API Key.
   
5. Copy the API key shown, you’ll enter this in the Agile Sync configuration.

Refer to this article for more details on how to get a Google API key for your projects.

Note: Keep this key private. Do not share it publicly.

4- Store ID Field

For successful synchronization, it is mandatory for your Google Sheets file to have an ID column (or Store ID) that numbers the stores in your sheet.

Without the store ID column, Agile Sync will not be able to synchronize your Google Sheets file with Agile Store Locator.

Enable Google Sheets API

Before the sync can work, the Google Sheets API must be enabled in your project:

1. In the same Google Cloud project, go to Library.
   
2. Search for Google Sheets API.
   
3. Click Enable.
   

Sheet Access Settings

Ensure the Google Sheet is shared with view access for anyone with the link. Agile Sync won’t be able to read data from private or restricted sheets.

Sheets with restricted access (e.g., “only you”) will result in sync failure.

How to Create Your First Sync Job with Google Sheets

Follow the steps below to set up your first Agile Sync job using Google Sheets as the source platform.

Step-by-Step Instructions

1. Log in to your WordPress Dashboard
   Make sure you have admin access to manage plugins and settings.
   
2. Navigate to Agile Sync
   In the sidebar, go to Agile Store Locator → Agile Sync.
   
3. Click “+ New Sync Job”
   This will launch the sync configuration wizard.
   
   
4. Enter a Sync Job Name
   Choose a name that helps you easily identify this sync job.
   
5. Select Platform: Google Sheets
   From the platform dropdown, select Google Sheets as your data source.
   
   
6. Enter Required Values
   
   1. API Key
      
   2. Sheet ID
      
   3. Sheet Name

These values were discussed in the previous section.

7. Click “Start Mapping”
   This opens the field mapping interface.
   

Field Mapping

In the Field Mapping section, match your Google Sheet fields to the store fields in Agile Store Locator.

Special Note:
1-  The api_item_id field must be unique within your data source. It serves as the identifier for each store record and is critical for detecting duplicates or performing updates.

2- If your data includes a field like updated_on, use it to represent the last modified date. This enables Agile Sync to only update records that have changed since the last sync, increasing efficiency and reducing API usage.

Once you’ve mapped all relevant fields:

8. Click “Save Mapping”

Set Sync Frequency & Finalize

9. Choose Sync Frequency
   Use the dropdown menu to set how often this job should run: hourly, daily, weekly, or manually.
   
10. Enable/Disable Sync Job
    Use the toggle to activate or pause the sync job.
    
11. Enable Email Notifications (Optional)
    Get a summary email every time the sync job runs; useful for tracking updates or errors.
    
    
12. Click “Finish”
    Your sync job is now created and ready to run based on the schedule you defined.

How to Test or Manually Trigger a Sync Job

After setting up your sync job, it’s important to validate that the connection, mapping, and data import are all working as expected. 

Agile Sync provides a simple way to test your sync manually before automating the process.

Step-by-Step: Testing Your Sync Job

1. Navigate to Agile Sync Dashboard
   Go to Agile Store Locator → Agile Sync from your WordPress admin panel.
   
2. Locate Your Sync Job
   Find the sync job you just created (by name) in the list.
   
3. Click “Execute”
   You’ll see an “Execute” button next to the job name. Click it to manually execute the sync.
   
   
4. Wait for Confirmation
   Agile Sync will begin fetching and importing store data from the connected Google Sheet. A success message will appear once the sync is complete.
   
5. Check the Stores in Agile Store Locator
   Go to Agile Store Locator → Manage Stores to confirm that the synced records have been created or updated correctly.

Re-run If Needed

If you make changes to your Google Sheet, you can repeat the process by clicking “Execute” again to pull in the latest data.

Check Notification Emails (if enabled)

If email notifications were turned on during sync setup, check your inbox for a summary report. It will include:

• Number of records added
  
• Number of records updated
  
• Skipped entries (if any)
  
• Any errors or validation issues

For any questions, issues, or concerns, please reach us at the following email address:support@agilelogix.com