Skip to main content
ShelterLuv is read, not written. Your animals come in to RescueConsole on a schedule; nothing here is sent back. Only an organization admin can set it up or change it, under Settings → Advanced & security → Integrations.

What it does

Version 1 of their API documents animals and nothing else, so animals are all that can come in, and there is nothing to send out.

What you need

An API key from ShelterLuv, and nothing else. A key belongs to one shelter, so there is no account number or organization ID to type: the key is the account. In RescueConsole, you need to be an Organization admin.

Setting it up

1

Get a key from ShelterLuv

Ask ShelterLuv for API access for your shelter. They issue the key.
2

Add the integration

In RescueConsole, open Settings → Advanced & security → Integrations, find ShelterLuv under Shelter management platforms, and add it.
3

Paste the key

Enter the API key and press Save it. It is stored and never shown again.
4

Test the connection

Test the connection asks ShelterLuv for a single animal and reports back in their own words.
5

Turn animals on, coming in

Under Which way choose In, tick Animals under What to sync, choose How often, and Save.
6

Choose which animals

Under Taking records in, Which animals starts on In custody now. Choose Every animal they ever took in to bring in their whole history.
7

Take them in once by hand

Press Take records in now. Nothing runs on its own until a run has worked. After that it keeps going by itself on the schedule.

What moves

ShelterLuv has no way to tell us that something changed, so RescueConsole goes and looks on the schedule you set.
The first walk brings in the animals ShelterLuv has in custody for you, or every animal they ever took in, as Which animals says, 35 animals a run until it reaches the end, and every run keeps to that choice. After the first walk, only the ones changed since come in. Each animal keeps its ShelterLuv ID, so removing the integration and adding it again updates the animals already here rather than bringing them in twice. Under What to sync, Fields lists their fields for animals. With nothing chosen, every field there is a mapping for comes in. Their statuses says what each ShelterLuv status becomes here. When theirs changes, the animal’s follows. Each run says how many animals were added, updated and left alone, and how many they list. A run that has not reached the end says There are more; run it again, or wait for the next scheduled run.

When it goes wrong

When a run fails, the window says Last run said: and the reason, in ShelterLuv’s words where they gave any. Under it: It tries again on its own, waiting longer after each failed try (never more than a day), and this stays until a run works. The same reason shows under the integration’s name on the Integrations page. The reasons it gives:
  • ShelterLuv refused that API key. Check the key in ShelterLuv and enter it again. Paste the key in its box and press Replace it.
  • ShelterLuv could not be reached.
  • ShelterLuv answered and a number, followed by their own words when they gave any.
Put it right, then press Take records in now. Once a run works, the schedule starts again. When ShelterLuv asks RescueConsole to slow down, that is not a failure: the run says ShelterLuv asked us to slow down, so reading stopped for so many seconds, keeps what it read, and the next run is due when they said.