Skip to contents

Retrieve a data frame of all mailing lists from Qualtrics

Source: R/all_mailinglists.R
all_mailinglists.Rd

Retrieve a data frame of all mailing lists from Qualtrics

Usage

all_mailinglists()

Details

This function uses the Qualtrics XM Directory API. The directory it queries is discovered automatically from your account. If your account has more than one XM Directory, set the QUALTRICS_DIRECTORY_ID environment variable to the directory ID you want to use; otherwise the first directory returned by the API is used (with a warning).

If the request to the Qualtrics API made by this function fails, the request will be retried. If you see these failures on a 500 error (such as a 504 error) be patient while the request is retried; it will typically succeed on retrying. If you see other types of errors, retrying is unlikely to help.

Examples

if (FALSE) { # \dontrun{
# Register your Qualtrics credentials if you haven't already
qualtrics_api_credentials(
  api_key = "<YOUR-API-KEY>",
  base_url = "<YOUR-BASE-URL>"
)

# Retrieve a list of all mailing lists
mailinglists <- all_mailinglists()
} # }