Integrations
Other
Pigment
6 min
import your hired candidate profiles into pigment to use them in your reporting and headcount planning you need to be a https //community gopigment com/getting started 86/how to add users and modify account types in pigment 286 to configure the connector how does the ashby connector work? the ashby connector imports data from all hired applicants into pigment this is done by securing an api key from ashby, establishing a connection to pigment, and then importing the data into the selected block when running an import from ashby, the import contains all hired applications and certain default fields and allows for selection of custom created fields these are the default fields from ashby application id employee name department job id job title target start date actual start date salary salary currency custom fields can be selected when setting up the import establishing the connection between ashby and pigment a connection between pigment and ashby must be established before importing data into pigment the first step is to get an ashby api token, this will be needed when establishing the connection within pigment after getting the api key, a pigment workspace admin can set up the connection in integrations page and establish which applications can use the connector the last step is setting up an import and selecting the connection generate an ashby api token to generate an ashby api token a user must have their role set to org admin sign in to ashby and click admin in the top navigation bar next, click integrations on the left panel of the screen search the pigment integration and click + create api key for pigment copy the value provided you could also save the key somewhere secure for future reference set up the ashby connector in pigment from the workspace home page, navigate to settings → integrations and click on + add next to the ashby integration click setup a connection and then fill in the following 2 fields these fields will remain editable if you need to add additional applications or rename name give a name to your connection (ex “ashby connection”) application access list of applications that will be allowed to use this connection api key the token you generated at the previous step click on setup to finish load ashby data into pigment once the ashby connection is configured, navigate to an application where the connection is available from there click import data for the object you want to import data into for example, if you were importing into a transaction list, you would open up the list, then select import and download and then import data click on the integration tab and select the previously configured ashby connection from the dropdown select the custom fields you would like to include, if any each import will include all hired applicants with the following default fields from ashby application id employee name department job id job title target start date actual start date salary salary currency if you do not see the ashby connection you have configured, make sure the current application is listed under the authorized applications for this connection to fix this, go back to the setting’s integrations page, and check that the application is on the application access list