Skip to main content
RescueGroups.org is read, not written. Your records there 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. That is deliberate. A direction is offered once something behind it moves, and nothing sends a record to RescueGroups yet.

What it does

Organizations are not on the list. RescueGroups has no such thing for a rescue.

Download all your RescueGroups data

Download all your RescueGroups data, on the integration’s settings, takes a copy of everything the integration’s login can read in RescueGroups: your animals, contacts, journal entries, forms and their answers, adoptions, events, the files you keep on animals and contacts, and every other kind of record their API gives a rescue. It is for keeping, or for looking through before you bring your records in. Only an organization admin sees it, and it needs a RescueGroups username and password: an API key reads your public listings and nothing else.
1

Take a copy

Press Take a copy. The copy is taken in the background, a few pages at a time so their server is not rushed, and a large history takes a few hours; the card says how far it has got. Each kind of record then has a download: one spreadsheet (CSV) with a column for every field, and, where a field holds several things at once (a form’s answers, for example), a spreadsheet of its own with one row for each.
2

Download the zips

Once every kind of record is copied, the copy fetches your files themselves: the files on your animals and contacts, signed in to RescueGroups with the integration’s login, and your website’s images. A large history takes most of a day; the card shows how many have come. When the last file has come, Download as zips offers every spreadsheet in one zip, and your files in zips of about 2 GB or 900 files each, whichever comes first, in folders by animal and person (for example Animals/Biscuit (12345)/rabies certificate.pdf). Each zip downloads straight to your computer; if a download stops, press it again.
3

Delete it when you have finished

The copy, its files and its zips are kept until you delete them with I have finished with it: delete this copy. A copy taken before your newest is listed under Earlier copies, with the day it was taken and its own Delete button, so nothing is kept in storage that you cannot see. A copy deleted while it is still being taken stops, and what it had kept goes with it.
A kind of record your login is not allowed to read says so and the rest goes on. When RescueGroups’ own server fails for a moment, the copy says so on that kind of record and tries again on the next run, from where it stopped; only after an hour of failing is a kind of record left out. Your submitted forms are copied first. The registration code a microchip registry gave your account is never copied. Your website’s files are tried at an address RescueGroups does not publish, and if their site will not open the first few there, the card says so and the rest are not asked for. A file that could not be fetched is listed, with the reason, in files-left-out.csv in the spreadsheets’ zip. Files kept this way are separate from the documents Animal files and Contact files bring in, described below. While you bring your records in, the imports read the copy rather than asking RescueGroups again: each kind of record you import, with Take records in now or on the schedule, comes from the copy, and the run says so. A kind of record whose import asks for a field the copy does not hold reads RescueGroups instead, and the run names the field. The field list under each kind of record is read from the copy too, with how many of your records fill each field and with what, and each table of their words (statuses, contact groups, journal entry types, forms and form statuses) lists the ones your records use, to add one at a time. The card says which kinds of record have come in from the copy and which are still to come.

What you need

Either will do, and they do not see the same things. RescueConsole says which you have given, so a screen never offers you People when your credential cannot see a contact. You also need your account number, which RescueGroups shows in your account, and to be an Organization admin in RescueConsole.

Setting it up

1

Get the credential from RescueGroups

In RescueGroups, open your account settings and either generate an API key or note the username and password you want RescueConsole to use. Their API developer guide explains where.
2

Add the integration

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

Enter the credential and your account number

Paste the key, or the username and password, and type your account number. Press Save it. A password or key is stored and never shown again. With a key, the account number goes under Your RescueGroups.org organization ID, with Save the ID.
4

Test the connection

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

Choose what comes in

Under Which way choose In, tick each record type you want under What to sync, choose How often, and Save.
6

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

RescueGroups has no way to tell us that something changed, so RescueConsole goes and looks on the schedule you set. A shorter schedule means fresher records and more calls against your account.
The first time, a large RescueGroups history comes in a part at a time: all your people first, then your animals, then journal entries, events and submitted forms, and adoptions last, so an animal’s foster, a form’s applicant and an adoption’s application are already in RescueConsole when they are looked for. Each part follows the last straight away, so a history of thousands of records takes hours rather than minutes.
Animals An animal comes in with its status as RescueGroups says it: available, adopted, transferred, reclaimed, released, lost, stolen, passed away or euthanized become the same here, and a word with no certain meaning, such as Returned or Hold, comes in as Intake Processing. Say what any of yours means under Their statuses in the integration’s settings. An animal with no received date in RescueGroups takes the day it was added there as its intake date, and its condition (Healthy, Treatable, Unhealthy) becomes its health status. An animal’s owner in RescueGroups is whoever it belongs to now. When the animal comes in adopted, or with another status that means it has left your care, its owner becomes the person it went to, and an adopted animal lists its adopter on the Relationships tab. An animal still in your care takes no owner from RescueGroups. Submitted forms A submitted form comes in closed when RescueGroups closed it. Adopted, approved or accepted approves the application; denied, declined or rejected denies it; canceled, expired, deleted, incomplete or adopted elsewhere withdraws it. Any other status leaves it open for you. If your RescueGroups account uses statuses of its own, say what each does under Their form statuses in the integration’s settings. Contracts, agreements and waivers are not applications, whatever their name says; to bring one in anyway, name it under Their forms. Every submitted form comes in, with its answers. Each RescueGroups form is copied to Settings → Operations & forms → Forms, marked From RescueGroups, and each form somebody sent becomes a submission on it in Submissions: volunteer forms, intake requests and contracts as well as applications. A copy asks their questions in their order, with their headings as its sections and a contract’s terms kept word for word, so it is a record of what was asked, and it cannot be published. A submission comes in on the person who sent it when they are already in RescueConsole, and none comes in as new, so nothing lands in your Inbox. An adoption or foster form is an application too, and each names the other. RescueConsole brings in forty forms at a time, so a long history can take a day to arrive in full. People A person’s roles come from the contact groups they are in on RescueGroups. Adopter, Volunteer, Donor and Caretaker/Foster give a role on their own. For any other group, such as one you made for a program or a location, say which role it gives under Their contact groups in the integration’s settings. A group nobody names gives no role, and a role is never taken away. A contact whose Send mail is No in RescueGroups comes in with Marketing mail (Mailchimp) turned off, and nothing else: they still get workflow emails and an adoption’s paperwork. RescueGroups changes it again only when theirs changes, so turning it back on here stays. Every contact group also comes in as a tag on the person, so you can filter your people by it. Their Do Not Adopt group marks the person Do not adopt here, with the group named as the reason: your rescue’s own mark, which is never added to the Public Registry. To have another group of yours do the same, choose Do not adopt for it under Their contact groups. A tag or a mark you take off here stays off, unless the person’s groups change in RescueGroups. Journal entries A journal entry’s cost comes in as the medical record’s Cost, and the animal’s total is the sum of them, as RescueGroups’ own is. A journal entry becomes a medical record of the kind its type names, so “Rabies vaccine” is a vaccination and “microchip” a procedure. When the type’s words say nothing, such as a drug’s name, its RescueGroups category decides: under Medications it is a medication, under Flea/Tick/Deworm or De-worming a preventative, and under Test a test. A Weight entry becomes a weight on the animal, read from what was typed in it, such as “8 lb 6 oz”; one with no unit is left out, and the import says so. Other types under Miscellaneous, such as Adoption or Training Class, are not medical and are left out; say what any of yours is under Their journal entry types. Events An event comes in at its venue: the RescueGroups location’s name and address. The location itself comes in once, under Settings → Locations, as an adoption center if animals are kept there and an event venue otherwise. It is not public and never your main location until you say so; change it there as you like, and RescueGroups changes it again only when theirs changes. A location of theirs that holds no events is left out. Files Files you keep on animals and contacts in RescueGroups come in as documents on the animal or the person, titled with their description, or their name when there is none, and noted From RescueGroups. Their files are not at a link anybody can open: RescueConsole signs in to the RescueGroups site with the integration’s username and password to fetch each one, so files need a login, not an API key. The list comes in with the rest; the files themselves follow a few at a time in the background, about forty every few minutes, so a large history takes a day or more to arrive. Files deleted in RescueGroups are left out, and so is a file over 10 MB or of a type documents do not take; the import says how many. A document’s text is read once it arrives, as it is for one you upload. Adoptions Adoptions come in as RescueGroups recorded them. A successful adoption is finalized on its day, with the RescueGroups adoption number as its receipt number (RG- and the number), and a returned one is reversed. When an animal was adopted more than once, the latest adoption is the one that stands and the earlier ones are reversed; an adoption of an animal RescueGroups now lists as back in your care is reversed too. An adoption made from a submitted form is joined to its application. The fee is the one RescueGroups recorded, and any donation with it is noted on the adoption. Its lead, where the adopter came from, becomes its source, added to your list of adoption sources the first time it is seen; a source you choose here is never replaced by theirs. They happened in RescueGroups and were paid for there. So nothing is owed on them here and no pay link is offered, their receipts are not emailed from here, no workflow starts for them, and RescueConsole does not bill them. An adoption you recorded in RescueConsole is never changed by one from RescueGroups; one of theirs dated after yours, for the same animal, is left out and the import says so. Adoptions come in after your submitted forms, so the form an adoption came from is already here.
Records brought in from RescueGroups do not start your workflows. An application approved there last year, or a foster placed there, already happened, so no checklist starts and no workflow email goes out for it, not even from a workflow set to start a number of days after a record is added. Workflows start as usual for everything you do in RescueConsole.

When it goes wrong

When a run fails, the window says Last run said: and the reason, in RescueGroups’ own 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. Put it right, then press Take records in now. Once a run works, the schedule starts again. A new key or password is typed again in its box and saved with Replace it. One record RescueConsole cannot bring in does not stop the rest: the run leaves it, says One of their animals could not be brought in (or people, or forms) with the reason, and tries it again on the next walk through their records. Each animal and person brought in keeps their RescueGroups ID. If you remove the integration and add it again, the records already here are found by that ID and updated, not brought in a second time. With an API key and no account number, Test the connection waits and says Needs the key and the organization ID above., and saving In is refused: Add your RescueGroups.org organization ID first. Without it, taking records in would pull every rescue’s. A record type an API key cannot see cannot be ticked under What to sync, and says so: An API key cannot read people from RescueGroups.org. A login can.