> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.syncspider.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # How to Create a Task - SyncSpider - Help Center **TABLE OF CONTENTS** * [What is a Task?](#What-is-a-Task?) * [How to Create a Task](#How-to-Create-a-Task) * [Step 1: Access the Tasks Panel and Start a New Task](#Step-1%3A-Access-the-Tasks-Panel-and-Start-a-New-Task) * [Step 2: Choose Your Integrations](#Step-2%3A-Choose-Your-Integrations) * [Step 3: Select Entities](#Step-3%3A-Select-Entities) * [Step 4: Connect Your Apps](#Step-4%3A-Connect-Your-Apps) * [Step 5: Configure Your Source Integration](#Step-5%3A-Configure-Your-Source-Integration) * [Step 6: Apply Filters (Optional)](#Step-6%3A-Apply-Filters-(Optional)) * [Step 7: Configure Your Target Integration](#Step-7%3A-Configure-Your-Target-Integration) * [Step 9: Mapping](#Step-9%3A-Mapping) * [Step 10: Task Settings & Scheduling](#Step-10%3A-Task-Settings-&-Scheduling) ## ## What is a Task? A **Task** in SyncSpider represents a workflow that automates data transfer between different applications or systems. Each time a task runs, it performs operations to move data from one system to another. For example, a task can send **Facebook Leads** to your **CRM** or export them to a **CSV file** before transferring them to the CRM. * A task can be **simple (one step)** or **multi-step**, involving multiple applications and transformations. * Tasks are organized under **Organizations** or their **Projects**. * If you have an **Agency account**, you can access **Sub-Accounts** (sub-organizations) and all related projects. --- ## How to Create a Task ### Step 1: Access the Tasks Panel and Start a New Task Log in to your SyncSpider account. On the left-hand navigation panel, click on the **Tasks** icon (?) to access the task management page. To create a new task, click on the **"Add new task"** button at the top right of the screen. ![Click Task icon and Add new Task](https://storage.crisp.chat/users/helpdesk/website/-/2/5/5/f/255f98a040381600/3a7e80fd-e26c-4579-92d9-b3ee85_u7tb9h.png) --- ### Step 2: Choose Your Integrations Once you've clicked **"Add new task"**, the next step is to define the applications you want to connect. You'll see a screen prompting you to **choose your integrations**: * **Source Integration** (the system where your data originates). * **Target Integration** (the system where your data will be sent). Click on the **"From" dropdown** to select your source application. Click on the **"To" dropdown** to select your target application. ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/c/8/78c89ebb0462dc00/5bd9a539-c497-463c-aa6c-7dc8e7_7dmtgz.png) **Important Note:** Before creating a task, ensure that the applications you want to use have been integrated with SyncSpider. If you haven't integrated them yet, you'll need to do so first. For detailed instructions, check out our [How to Integrate Articles](https://support.syncspider.com/en/support/solutions/folders/3000021047) folder to learn how to connect your apps.  --- ### ### Step 3: Select Entities After selecting your integrations, you'll need to **define the entities**—the specific data types being transferred. So once you've chosen your integrations, you'll see an additional field pop up under each application: * **Source Entity:** The type of data to extract from the source system. * **Target Entity:** The type of data that will be created or updated in the target system. The available entity options will vary depending on the application. Some apps may have multiple entity types, such as **orders, products, customers, or leads**, while others may have a more limited selection. Using the **Facebook Leads → Custom CSV** example: * **Source Entity:** Leads (Facebook lead data) * **Target Entity:** Custom CSV (structured file format to store the leads) ![](https://storage.crisp.chat/users/helpdesk/website/-/7/6/4/0/7640644560fc8c00/59ef0e32-a075-4661-b69d-3df660_1k0vxbm.png) Below this selection, SyncSpider will also show a **template options**: ![](https://storage.crisp.chat/users/helpdesk/website/-/6/b/c/0/6bc0ab87ece5ec00/6f60790b-762d-43dc-9139-2fe65b_1szmr9u.png) If there are existing **pre-configured task templates**, you can select one to simplify the process. If no templates match, you can proceed with manual configuration. **Custom templates** can also be created for your specific needs, please contact our support team at [[email protected]](/cdn-cgi/l/email-protection) for more information about setting up custom templates. Click **Next** to proceed to the next step. --- ### Step 4: Connect Your Apps After selecting your integrations and entities, you will be prompted to **connect the apps** to SyncSpider. Since SyncSpider allows multiple accounts/files for the same integration, you must select the specific one you want to use for this task. Click **"Connect"** to open the selection window or **"Change"** if you want to select a different account. ![](https://storage.crisp.chat/users/helpdesk/website/-/e/0/c/2/e0c23fcafaf9180/8d8ccae1-f3d9-4c0d-88d7-c4d7fe_167uf2u.png) Choose the specific account you want to use. Click **"Connect [App Name]"** to finalize the connection. ![](https://storage.crisp.chat/users/helpdesk/website/-/d/e/7/7/de777500effdd000/041a4010-4c94-499b-85f0-6a5a3f_o3pgaf.png) To proceed, make sure that both integrations have a green **"Connected"** status. ![](https://storage.crisp.chat/users/helpdesk/website/-/8/d/6/7/8d67c2e5673a7800/1ef0e75e-8131-410a-a068-8b85f0_oi8koc.png) Once both are connected, click **Next** to continue. ## --- ### Step 5: Configure Your Source Integration Now that your source application is connected, you need to configure it. The Source Configuration settings vary depending on the application you selected. Continuing with our Facebook Leads → Custom CSV example, here the source configuration requires you to: * **Choose Page:** Select the Facebook Page where the leads are being collected. * **Choose Form:** Select the specific Lead Form used for collecting data. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114572769/original/TYDXsZEix78ip9-aBc5FDp_OUPsPA5AZfA.png?1740578862) Once you've selected the appropriate source settings, proceed by clicking **Next**. --- ### Step 6: Apply Filters (Optional) Filtering allows you to **control which data is imported** from your source system. This step is optional but can be useful for refining your task. With filters you can choose to: * **Import all available data** (default). * **Import data from a specific date onward** by selecting a date in the **"From date"** field. * **Import only new data** since the last time this task was run. * **Filter based on specific conditions**, such as importing only certain values from a dataset. For example, if you're importing customer data, you can set filters to only retrieve leads from a particular country, status, or source. **For example, you're importing WordPress data to an email marketing platform, you might filter by subscriber status to only include "active" users.** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114573454/original/0PcY9T2Kwzyp6kpiAKYzcDUbFDVNCXFKMw.png?1740579976) For the Facebook Leads → Custom CSV example, if you only want to import leads collected **since the last sync**, you can set a filter accordingly. If no filtering is needed, simply leave it as and continue. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114573299/original/SdZAo9V0z_c1v78taCZ9B_wAJjvWzGaSUg.png?1740579665) Once you've set your filtering preferences, click **Next** to proceed. --- ### Step 7: Configure Your Target Integration The **Target Configuration** step allows you to define how the data should be structured and processed when it reaches the target system. As with the Source Configuration, the settings available in this step will vary depending on the target integration you selected. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114574054/original/AplAWGIc-iT7XguSgKtmKrXX4-m8e74caw.png?1740581092) For our Facebook Leads → Custom CSV example, since the target integration in this case is a CSV file, the configuration settings include: * **Upload sample for setup** – Allows you to upload a sample CSV file to define column structure. * **Name of output file** – Defines the name of the generated file. * **Column separator** – Specifies how values in the CSV file are separated (e.g., comma, semicolon). * **Values enclosure character** – Defines how text values are enclosed (e.g., quotation marks). * **Overwrite file each time behavior** – Determines whether new data should overwrite the existing file or append to it. * **File encoding** – Specifies encoding format (e.g., UTF-8). * **Remove Header** – Lets you choose whether the file should include a header row. * **Output file URL** – Shows the location where the generated CSV file can be accessed. In this step, you can also **customize how the data is structured** when it is sent to the target integration. This is particularly important for CSV files or other formats that require column mapping. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114574228/original/41ivbyWQo3mM7InibYMgkzwet-6UFh3aTg.png?1740581405) #### **Key Options:** * **Add Columns** – Click the **“+ ADD COLUMN”** button to define new columns in the output file. (e.g., Email, First Name, Last Name, etc.) * **Column Name** – Enter a name for each column, which will determine how the data is labeled in the exported file. * **Value Type** – Choose the data type for the column (e.g., Text, Number, Boolean, etc.). * **Required** – Check this box if the column is mandatory for the file to be valid. * **Enable export items to separate files** – If selected, SyncSpider will generate separate files instead of consolidating all data into one. * **Fill columns with parent data** – This ensures that related data entries maintain hierarchical relationships. Once all necessary settings are configured, click **Next** to proceed. --- ### Step 9: Mapping Mapping is the process of **matching data fields from your source integration to your target integration**. This step is highly customizable and varies depending on the applications you are using and what you want to achieve. * The **left panel** displays available fields from your **source integration**. * The **right panel** represents the fields in your **target integration**. * You will need to **drag and drop** fields from the source panel to the corresponding fields in the target panel. #### **Key Points About Mapping:** * **Mandatory Fields:** Fields marked with an **orange dot** must be mapped for the task to execute properly. * **Custom Fields:** You can create and map [custom fields](https://support.syncspider.com/en/support/solutions/articles/3000115871) if your required data is not available by default. * **Saving a Mapping Template:** If you regularly use the same mappings, you can save them as a [template](https://support.syncspider.com/en/support/solutions/articles/3000115425) for future tasks. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114574865/original/eTRhIOvolEdeQTZ7-kfbmJFHTekgd-fRMA.png?1740582432) For our **Facebook Leads** to a **CSV file example**, you'll see that **Email** is marked as a mandatory field and additionally you might map fields like: * **First Name → First Name (CSV Column)** * **Last Name → Last Name (CSV Column)** Once your mappings are set, click **Next** to proceed. --- ### Step 10: Task Settings & Scheduling The final **Task Settings** step allows you to define how and when your task runs. This includes setting a task name, automation triggers, activation options, logging, and notifications. ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575211/original/6539DbGeALumVXK8AeQxFklFjMKCzsmCmQ.png?1740582811) **Breakdown of Task Settings Sections:** **1. Task Details** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575389/original/gll-_VmWTQUBV4wrrhGz_KLCiif-WWg6Ow.png?1740583170) **Task Name:** Assign a name for the task to easily identify it in the dashboard. **Task Description:** Provide details about what this task does (e.g., "Send Facebook Leads to Custom CSV"). **2. Task Automation (Scheduling & Triggers)** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575367/original/8t5p8_FBuayN_-Y7rawgeFOLfO7y7B9xaA.png?1740583127) Choose how the task will run: * **Schedule:** Set the task to run automatically at specific intervals (e.g., hourly, daily, weekly). * **On Event:** Trigger the task based on specific actions (e.g., when new data is received from the source). Click **"Add Trigger"** to add multiple triggers. **3. Task Activation** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575411/original/Bz93epJ2Lff_FX8M2xCDzPWTYHyt7Jh9Cw.png?1740583201) Toggle the switch to **activate or deactivate the task**. Enable **Auto-Repeat** if you want the task to run on a loop without manual intervention. **4. Task Logging** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575425/original/1_6wR6R_OFZerP1vgVC0X-G7d5MrnVKYRg.png?1740583239) Enable logging to track details of each task execution. Logs can help with **troubleshooting errors** and **monitoring task performance**. **5. Email Notifications** ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/3114575459/original/Y2vNyAuWHeB5Xc-6Ic_7vBjJcsQyPLXq2Q.png?1740583289) Specify who should receive email notifications based on the task's outcome: * **Success Notification:** Get an email when the task completes successfully. * **Warning Notification:** Get notified if the task completes with issues. * **Failure Notification:** Receive an alert if the task fails to execute. Once all settings are configured, click **"Finish"** to save and activate the task. Your task will now be listed in the **Tasks Dashboard**, where you can manually start it or let it run based on your scheduled triggers. We hope that this covers everything. If you have any further questions or need additional clarification, please reach out to us via [[email protected]](/cdn-cgi/l/email-protection#b3c0c6c3c3dcc1c7f3c0caddd0c0c3dad7d6c19dd0dcde) or our Chat Widget!