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:
- Request and receive an API key from Shelterluv's support team
- Opt-In on your SAC Portal.
- Map all of your organization's unique subtypes in your SAC portal
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 info@shelteranimalscount.org.
Set Up the Integration
Follow these steps to set up and active your SAC API integration:
Each of the three steps must be fully completed before your integration will work.
-
Step 1: Generate an API Key
All API keys for your Shelterluv account must be generated on our end by our support team. To request an API key, please submit this form. Once the form is submitted, Shelterluv's support team will reach out when the key is generated.
You can find more detailed step-by-step instructions on this here - How to Generate an API Key
-
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:
- Log into your SAC data portal linked here.
- Click your username and choose Organization from the dropdown menu.
- Click the blue Edit Organization button.
- At the bottom of the screen, enter the three fields for the API and click Update (screenshot below).
- 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:
- Log back into your SAC portal.
- 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.
- 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.
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