How to import tasks

Instructions on how to import tasks

**To use this, you must have a Trial, Professional, or Business Level account


Part 1: Import all four types of data

If you are using a unique identifier that is not a default field in ProsperWorks then:

Set up custom fields for all “Companies”, “People”, “Opportunities” and “Leads” data. For example we can create a custom field called “External ID” for your original data identifier.

Part 2: Make a copy of our spreadsheet


  1. Click this link for the spreadsheet


  1. It will ask you to make a copy. Please click to make a copy.


  1. If you do not have our Custom Report Build add-on, download it:

Part 3: On your copy of the spreadsheet


  1. Type in your registered ProsperWorks email address and copy/paste in your API Token from ProsperWorks ⇨ Settings ⇨ API Keys ⇨ Generate API Token ⇨ Copy/paste it here


  1. In the menu, go to Add-ons -> ProsperWorks CRM Custom Report Builder -> Import data

  1. In “Choose what you want to import” put the Related Type you need. I’ll take Companies as an example, so select Companies



  1. In “Choose a filter,” we need all company records. So we select “All Companies.”, and hit “Import data”.

  1. You will wait for it to load

  1. You should see a new sheet named as this at the bottom

  1. Rename this sheet to “companies”


  1. Repeat step 2 to step 7 for the other 4 resource types “opportunities”, “people”, “leads” and “projects”.

Note: they have to be renamed to “opportunities”, “people”, “leads” and “projects”. For opportunities, you may need to extract all opportunities from every pipeline, then combine them into one sheet.


The sheets tabs should look like this:

(If you are not using one of the tabs, just create a empty tab with that name. The tab still has to be there.)


  1. Then we need to modify each of the data sheet.

If you are using original data ID, dragg “External ID” column to the first column of that sheet:

If you are just using ProsperWorks ID, you can duplicate the first column:


  1. Repeat step 9 for all other data sheets.


Part 4: Fill in task data into Sheet 1


  1. There are 7 columns you can input task data.

Only the first column is required. Task will be skipped when empty cells were found.


Then 6 optional columns. “Related ID” and “Related Type” will give task a primary related resource. “User Name” will assign the user to task. You can also specify the “Status” of task to “Open” or “Completed”.


The last 2 columns are status indicator. You don’t have to input anything here. “*Progress*” can be “Done”, “Skipped” or “Not found” (when related entity is not found on the data sheet). When one task is successfully imported, “*Task ID*” will be the newly created ID of that entry for your reference.


  1. For “Related ID” column, this is where you put your “external ID” of the related entity that task should be linked to. It matches the “External ID” column of the corresponding data sheet.


  1. “Related Type” column has to be one of the 5 data types: “company”, “opportunity”, “person”, “lead” or “project”. Data validation on this column can also help you get the right input.


  1. As for “User Name” column, you can use the “Get users list” helper from ProsperWorks menu => Get users list. Just paste the user name into the column so he will be assigned to the task.


  1. “Status” column can only be set to “Open” or “Completed”. Data validation should also help.


  1. “Description” column is where you put the content of task in. Could be simply paste from your source data.


  1. You can input formatted date or time string in “Due Date” column. The spreadsheet will try to parse it into a UNIX timestamp.


  1. After all columns are filled in, now we can start the importing process by hitting ProsperWorks menu => Import tasks

  1. It might ask you for authorization. Click “Continue”


  1. Click Allow

  1. You will see a notification saying “Running Script”


You can also check the “*Progress*” column for the running status.


  1. You are done!


  1. If you get some errors while running the script, you can REFRESH the page, modify the row that is causing the error. Then remove all the rows above it that has a “Done” in the “*Progress*” column preventing duplicate tasks. Just remember to right click on the rows => Delete cells => Shift up. You can also add more info to those “Skipped” ones. Then run the script, ProsperWorks menu => Import tasks, again.

If you have any questions, please make a support request here

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Article is closed for comments.