Step 1: Overview

This guide walks you through configuring Accio to work with Ferretly so you can order social media reports and receive them through Accio. Ferretly provides this integration for partners with active subscriptions.

Continue → Step 2

---

Step 2: Prerequisites

- Active Ferretly and Accio accounts

- From Ferretly:

- Remote account name (Ferretly Organization ID)

- Remote username (Ferretly account email)

- Remote password (Ferretly API key)

- Ability to locate your Accio post back URL and email it to Ferretly

- Accio permissions to add/edit vendors, site setup, and field labels

Continue → Step 3

---

Step 3: Add Ferretly as supplier

  1. Sign in to Accio.

  2. Go to OperationsVendors & Work QueuesAdd/Edit vendors and work queues.

  3. Select Add an Accio XML integrated supplier from the dropdown.

  4. Enter:

Field

Value

---

---

Vendor name

Ferretly Social

Remote account name

Your Ferretly Organization ID

Remote username

Your Ferretly account email

Remote password

Your Ferretly API key

URL to send orders to

https://accio.ferretly.com/api/BackgroundReportHandler/subjects

Send subject’s phone number and email in order XML

YES

Send client info to supplier?

YES (so client info is sent to Ferretly)

Continue → Step 4

---

Step 4: Set Accio profile

Ferretly supports one or more report profiles used when running a social media check. By default, the Ferretly user account tied to the credentials has a default report profile assigned on subject creation. That profile can be edited for keywords, behaviors, report language, and more.

To use dynamic profiles via Accio (a profile other than the Ferretly default):

  1. In Accio, go to OperationsSite CustomizationSite Setup.

  2. Expand Vendor ConfigurationAccio Integrated.

  3. Find Ferretly Profile.

The Accio profile is a static value the CRA can set. It is not selectable during order entry, but it can be set at global, account, or package levels.

Continue → Step 5

---

Step 5: Provide Ferretly with your Accio post back URL

The post back URL is your unique hyperlink Ferretly uses to post reports back to Accio in XML format. It appears at the bottom of the page when entering supplier data (step 3)—a bold bullet similar to:

https://someclient.com/c/p/researcherxml

The hostname portion is unique to each client.

  1. Copy your post back URL.

  2. Email it to your Ferretly contact.

  3. Ferretly engineering completes configuration of the integration.

Continue → Step 6

---

Step 6: Change Accio field descriptions

To capture social media profiles and identity data, rename the following Accio fields:

Accio field

Rename to

---

---

Address <address>

Facebook

License Issuer <license_issuer>

Instagram

Roll Number <roll_number>

Twitter

License Number <license_number>

LinkedIn

Driver’s License Number <dlnum>

Reddit

Tax ID number <tax_id_number>

TikTok

Non-US Government ID# <intlgovtid>

College

Non-US Government ID description <intlgovtid_descr>

Employer

Continue → Step 7

---