How to Use the Shelter Animals Count API Integration to Automatically Map Your Data

Shelter Animal's Count (SAC) has an API integration that you can set up to take advantage of automatic intake and outcome data uploads, complete with automatic monthly tallying and custom subtype mapping!

Once your integration is set up and active, you do not need to manually upload your data to SAC ever again.

The setup process is made up of three simple steps:

1. Generate an API key in your Shelterluv account.
2. Opt-In on your SAC Portal.
3. Map all of your organization's unique subtypes in your SAC portal

Note
SAC's API integration is built by their team and is not managed by Shelterluv. We only provide SAC access to your data via our API once you complete the setup process. Since SAC built and manages the integration, you need to address any issues you may experience with them at [e-mail].

Set Up the Integration

---

Follow these steps to set up and active your SAC API integration:

 

Note
Each of the three steps must be fully completed before your integration will work.

• Step 1: Generate an API Key

  You can generate an API in your Shelterluv account by navigating to your gear icon > Configuration > Uploads and Integrations > My Organization's Website.

  You can find more detailed step-by-step instructions on this here - How to Generate an API Key

  Copy the API key to your clipboard as you will need to to paste it into your SAC portal in the next step!

  

• Step 2: Opt-In on your SAC Portal

  Now that you've created and copied your Shelterluv API key, head over to your SAC account and follow these steps:

  1. Log into your SAC data portal linked here.
  2. Click your username and choose Organization from the dropdown menu.
  3. Click the blue Edit Organization button.
  4. At the bottom of the screen, enter the three fields for the API and click Update (screenshot below).
  5. Wait 24 hours for SAC to collect your organization's data. You will receive an email from SAC once you're ready to move on to the next step.

  

• Step 3: Map your subtypes in your SAC portal

  After you've received SAC's email that your portal is ready, follow these steps:

  1. Log back into your SAC portal.
  2. On the API Mapping tab, you will see a list of your subtypes. Click the blue Edit button and map each item. Please refer to SAC's guide linked here (page 12) for details on choosing the right SAC category, as there are specific details to ensure everything is mapped appropriately.
  3. Once you're done, click the blue Save button. That's it! Your intakes and outcomes will now be counted automatically based on your custom mappings.

  

   

  Note
  You can change your custom mappings in your SAC account at any time.

PreviousNext

Uploads and Tallying

---

Monthly data will automatically upload to your data portal on the 5th of each month for the prior month (i.e. on August 5th, July data will be uploaded).

For your monthly totals, on the 5th of each month, your SAC portal tallies all the previous month's intakes and outcomes into their assigned categories. 

Please contact SAC's support team for more details on this and any other upload questions you may have.

Account Data SAC Collects

---

SAC's integration will pull the following fields from your Shelterluv account:

• Age
• Altered
• Animal_id
• Attributes
• Breed
• Color
• Date of birth
• Description
• In foster
• Intake type
• Intake subtype
• Name
• Outcome type
• Outcome subtype
• Pattern
• Sex
• Size
• Species
• Status
• Weight