--- title: Integrating with Spott slug: integrating-with-spott icon: ⚫ docTags: createdAt: 2026-04-10T18:19:51.067Z --- This guide covers: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem - [Creating an API Key](https://docs.pin.com/integrating-with-spott#generate-an-api-key-in-spott) - [Connecting Spott to Pin](https://docs.pin.com/integrating-with-spott#connecting-spott-to-pin) - [Configure job syncing](https://docs.pin.com/integrating-with-spott#configure-job-syncing) - [Syncing candidates to Spott](https://docs.pin.com/integrating-with-spott#syncing-candidates-to-spott) - [When candidates sync to Spott](https://docs.pin.com/integrating-with-spott#when-candidates-sync-to-spott) - [Candidate data synced to Spott](https://docs.pin.com/integrating-with-spott#candidate-data-synced-to-spott) ::: :::VerticalSplitItem - [Manually syncing a candidate to Spott](https://docs.pin.com/integrating-with-spott#manually-syncing-a-candidate-to-spott) - [Checking if a candidate synced to Spott](https://docs.pin.com/integrating-with-spott#checking-if-a-candidate-synced-to-spott) - [Disconnecting Spott from Pin](https://docs.pin.com/integrating-with-spott#disconnecting-spott-from-pin) - [Troubleshooting](https://docs.pin.com/integrating-with-spott#troubleshooting) ::: :::: Pin integrates directly with Spott (V2), so candidates and job positions you work in Pin can sync straight into your Spott pipeline. This guide walks through generating an API key in Spott and connecting it in Pin. :::hint{type="info"} **Before you start**: You'll need **admin access in Spott** to generate an API key, and access to **Settings → ATS** Integration in Pin to connect it. ::: *** # Generate an API key in Spott 1. In [Spott](https://app.spott.io/), click your workspace name in the top-left corner and select **Settings**. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/ArCKE1qpgCwZH-QXPCVlj_screenshot-2026-09-01-at-103804-am.png) 2. In the Settings sidebar, go to **API**, then click **+ Create API Key**. 3. Give the key a name that makes it easy to identify later — for example, Pin integration — so you (or your team) can tell at a glance what it's used for if you need to manage or revoke it down the line. 4. Click **Create Key**. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/BLvuZ0SWCCTsVdb6Y5Uta_screenshot-2026-09-01-at-103828-am.png) 5. Spott shows the new key once. Click **Copy Key** and save it somewhere safe — you'll paste it into Pin in the next step. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/W2un1SUA5jYH542OWTc6T_screenshot-2026-09-01-at-103841-am.png) :::hint{type="danger"} **One-time only: ****This is your only chance to copy the API key**. Spott will not show the key again. If you lose it, you'll need to generate a new one and reconnect. ::: :::hint{type="warning"} **Important:** A Spott API key is tied to both your workspace and the Spott user who created it — every action the integration performs will show as done by that user. If that person leaves or loses access, generate a fresh key from another admin account and reconnect. ::: *** # Connecting Spott to Pin 1. In Pin, go to **Settings → ATS Integration**. 2. Find **Spott (V2)** in the list of supported ATS platforms and select it. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/zKnCiCkW-crlxqO7b9UL3_screenshot-2026-09-01-at-104601-am.png) 3. Paste the API key you copied from Spott into the **API Key** field. 4. Click **Connect to ATS**. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/ixq2WPciAELWvYG1rDfml_screenshot-2026-09-01-at-104610-am.png) *** # Configure job syncing Once connected, the Spott (V2) card shows **Connected**, with a **Disconnect** option if you ever need to remove the integration. Below that, once you set the Sync option and ATS position on each job, Pin lists each job position, alongside: - **Sync to ATS** — the trigger that determines when a candidate on that position gets pushed to Spott (for example, once they're added to an outreach sequence) - **ATS Position** — the matching position in Spott that candidates should sync into ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/oUwQa5YzEj1oy6ep5Jw8j_screenshot-2026-09-01-at-104629-am.png) *** # Syncing candidates to Spott To sync candidates from each job in Pin to a specific job in Spott: 1. Go to **Job Settings -> Position Details**. 2. Scroll to the **ATS Integration** section. 3. Choose when to sync candidates by selecting one of the following triggers: - Never - They're added to an outreach sequence - Contact information is found - They receive their first message - They reply to an email - They reply to an email and are interested 4. Select the Spott job and stage you want to sync candidates to. Once you've selected your preferred triggers, Pin will automatically update the settings and sync candidates to the selected job in Spott based on the chosen trigger. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/5JtfVV-6X5KY2cccPYmsD_cleanshot-2026-09-02-at-115930-2x.png) :::hint{type="warning"} **Reminder: **You’ll need to **set up the syncing for each job** you want to send from Pin to Spott in the Position Details tab within the Job Settings. We recommend **setting up the job sync** **before adding candidates to Outreach**. This ensures candidates sync correctly to the job without issues. If you prefer not to sync candidates to a job, you can still set up a trigger and leave the job field empty. ::: *** # When candidates sync to Spott Once the selected trigger occurs, candidates will sync to Spott within a few minutes. For example: if you choose the trigger “Export candidates when contact information is found”, the candidate will automatically sync to Spott a few minutes after being added to Outreach. *** # Candidate data synced to Spott The following candidate data will sync to Spott from Pin: 1. Full name 2. Email 3. Phone number 4. LinkedIn profile URL 5. Location (city, state) 6. Current and previous roles 7. Education 8. A Pin-generated resume PDF 9. Profile photo :::hint{type="warning"} **Important:** Only contact information syncs to Spott, not message content. Pin does not push LinkedIn messages, sequence emails, or candidate replies to any connected ATS. ::: *** # Manually syncing a candidate to Spott If the candidate hasn’t synced yet: 1. Go to **All Candidates** and select the checkmark next to the candidate. 2. Click **“Export to ATS”**. 3. Choose the Spott job you want to sync the candidate to, then** click “Export” **to complete the sync. 4. After exporting, refresh the page, and you should now see the Spott logo appear on their profile. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/errusNBs3ILA78FwYb3jH_cleanshot-2026-09-02-at-112532-2x.png) :::hint{type="warning"} **Important:** - Once a candidate is synced to Spott, their contact information cannot be re-synced. If some information didn’t sync, you’ll need to **manually update** that candidate’s profile in Spott. - The **"Export to ATS" button **only works for candidates who haven’t already synced to Spott. If an integration was connected after the selected trigger, Pin won’t retroactively sync those candidates. In that case, use the "Export to ATS" button to sync them over. ::: *** # Checking if a candidate synced to Spott To confirm if a candidate has synced to Spott, you can open their profile in Pin. If you see the Spott logo, this means that they’ve been successfully synced. Clicking the logo will take you directly to their profile in Spott. ![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/HK7Fb7-mb_Vbl-U9oVgKo_cleanshot-2026-09-02-at-122930-2x.png) *** # Disconnecting Spott from Pin To remove the integration, go back to **Settings → ATS Integration → Spott (V2)** and click **Disconnect**. This stops the sync but doesn't delete anything already pushed to Spott. *** # Troubleshooting - **"Connect to ATS" isn't working / key rejected** — double-check the key was copied in full with no trailing spaces, and confirm it hasn't been revoked from the Spott side (Settings → API). - **A position isn't syncing** — check its **Sync to ATS** trigger and confirm an **ATS Position** is mapped; positions without a mapped ATS Position won't sync. - **Need a new key** — generate a replacement in Spott (Settings → API → Create API Key) and paste it into Pin the same way; the old key can then be revoked. *** ## Related - [Spott's API documentation](https://docs.spott.io/) — authentication, rate limits, and the full endpoint reference