SHOW MENU

Responses and errors Overview of responses returned by the API

Below are templates of the responses the Qualtrics Social Connect API returns for several types of API calls. This gives you an idea on what to expect as a result for your requests.

Eg.: the /me endpoint returns a single user object, wrapped in the standard envelope.

The default and preferred (!) response format for the Qualtrics Social Connect API is JSON. However we can also return XML if you pass "format=xml" as a GET parameter to our endpoints. Format and members of the XML responses are the same as for JSON responses, with the exception that items of numeric arrays are wrapped in an <item/> element.

Envelope for successful requests Structure of valid responses

  • {
    • "meta":
      • {
        • "code": integer The HTTP Response status code.
        • "messages": [] (optional) Holds an array of non fatal errors or warnings regarding to the request.
        • "etag": string (optional) If you send the HTTP Request Header "ETag/If-None-Match", we will send back a HTTP "Etag" Response Header. When the request & response hashes match, we return an empty "304 Not Modified". The ETag for a certain request will be included in the envelope if a HTTP Request Header "ETag/If-None-Match" is present.
        }
    • "response": … The actual response data.
    }

Error responses Structure of fatal error responses

  • {
    • "code": integer The HTTP Response status code.
    • "error": string Unique identifier for the type of error.
      • Possible values: "invalid_parameter", "no_permission", "not_found", "invalid_http_method", "unsupported_language", "internal_server_error", "invalid_protocol", "deprecated", "limit_exceeded", "feature_limit_reached", "unsupported_type"
    • "error_description": string Human readable description of the type of error.
    • "error_details": array (optional) Extra details about the error that occured (relevant id's, etc.).
    }

Objects Available fields for different type of json objects returned by API endpoints

account

  • {
    • "id": integer Unique identifier of the Qualtrics Social Connect account.
    • "name": string
    • "expires": integer
    • "expired": boolean (optional)
    • "plan": string
      • Possible values: "starter", "basic", "standard", "professional", "enterprise", "trial", "engagorv1", "free", "special", "reseller", "basicv3", "professionalv3", "enterprisev3", "starterv4", "professionalv4", "teamv4", "enterprisev4", "standard_v5", "enterprise_v5", "partner_v5", "casemanagement", "internal_only_inbox"
    • "projects": []
    • "users": []
    }
  • {
    • "key": string Identifier of the type of action
      • Possible values: "reply", "comment", "like", "hide_on_service", "delete_on_service", "block_user_on_service", "promote", "approve", "edit", "delete", "publish", "recent_conversations", "privatemessage", "retweet", "quote_tweet", "favorite", "submit", "reblog", "status", "assign", "tags", "sentiment", "note", "case", "mark_as_done", "mark_as_todo", "enable", "disable", "webview", "upvote", "verify", "suggest", "erase_pii_and_content"
    • "type": string (optional) Is this a link to the api or web application?
      • Possible values: "web", "api"
    • "name": string (optional) Verb describing the action
    • "title": string (optional) Description of the action
    • "link": string Url to where you can do this action
    • "http_method": string HTTP method used for the action
      • Possible values: "GET", "POST", "DELETE"
    • "post_params": string (optional) POST body used for this action
    }

app_details

  • {
    • "app_id": string (optional) ID of the app
    • "app_name": string (optional) Name of the app
    }

apple_payment_response

  • {
    • "success": boolean Indicates whether the payment request to Apple Messages for Business succeeded
    • "status": integer The status code returned by Apple Messages for Business
    • "body": string The response body returned by Apple Messages for Business
    • "headers": … The response headers returned by Apple Messages for Business
    }

assign_note

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this assign note.
    • "content": string The content of the assign note
    • "added_by": string
    • "date":
      • {
        • "added": integer (optional) UNIX Timestamp (in UTC) of when the assign note was added.
        }
    }

audit_log_item

  • {
    • "id": integer Unique identifier of the change.
    • "description": string Text describing the change.
    • "type": string The event description.
      • Possible values: "password_change", "login_success", "login_failure", "logout", "account_locked", "account_unlocked", "settings_edited", "password_reset", "admin_logged_in_as_user", "admin_logged_out_as_user", "user_registered", "password_changed_by_password_reset", "user_confirmed_email", "user_adds_user", "user_removes_user", "user_blocked_device", "user_blocked_location", "user_blocked_session", "user_added_by_casemanagement_sync", "login_success_cxstudiosso", "device_added", "location_added", "location_removed"
    • "user":
      • {
        • "id": integer (optional) ID of the user who did this change. Not available if anonymous change/change by Qualtrics Social Connect system.
        • "name": string (optional) Name of the user who did this change.
        • "email": string (optional) Email of the user who did this change.
        }
    • "password_strength": string (optional) Describes how strong the new password is.
    • "location":
      • {
        • "country": string (optional) The full country name of the new location.
        • "city": string (optional) The city name of the new location.
        • "latitude": float (optional) The latitude of the new location.
        • "longitude": float (optional) The longitude of the new location
        • "continent": string (optional) The continent code of the new location
        }
    • "device":
      • {
        • "platform": string (optional) The platform of the detected device
        • "browser": string (optional) The browser used on the device
        • "browser_version": string (optional) The version of the browser used on the device
        }
    • "dateadd": integer UNIX Timestamp (in UTC) of when the change was made in Qualtrics Social Connect.
    }

author_phone

  • {
    • "author_phone": string Phone number of the author
    }

business_hours_schedule

  • {
    • "id": string The unique identifier of the business hours schedule.
    • "name": string The name of the business hours schedule.
    • "timezone": string PHP Timezone identifier of the chosen timezone for this business hours schedule.
    • "summary": string The summary of the business hours schedule.
    • "periods": [
      • {
        • "dayofweek": integer Day of the week, Monday is 1, Sunday is 7.
        • "start": string `0000` for midnight, `2300` for 11 pm.
        • "end": string `0000` for midnight, `2300` for 11 pm.
        }
      • {
        • "dayofweek": integer Day of the week, Monday is 1, Sunday is 7.
        • "start": string `0000` for midnight, `2300` for 11 pm.
        • "end": string `0000` for midnight, `2300` for 11 pm.
        }
      • …
      ]       List of periods during which the business hours schedule is active.
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the business hours schedule was first created.
        • "updated": integer UNIX Timestamp (in UTC) of when the business hours schedule was last updated.
        }
    • "is_active": boolean If the current time is within the business hours.
    • "users":
      • {
        • "count": integer The number of users that have this schedule configured.
        • "count_with_status_available": integer The number of users that have this schedule configured, with status "available".
        • "count_with_status_busy": integer The number of users that have this schedule configured, with status "busy".
        • "count_with_status_unavailable": integer The number of users that have this schedule configured, with status "unavailable".
        }
    }

business_hours_schedule_period

  • {
    • "dayofweek": integer Day of the week, Monday is 1, Sunday is 7.
    • "start": string `0000` for midnight, `2300` for 11 pm.
    • "end": string `0000` for midnight, `2300` for 11 pm.
    }

button

  • {
    • "id": string ID of the button.
    • "label": string Label of the button.
    }

canned_response

  • {
    • "id": string The unique identifier of the canned response item
    • "name": string The name of the canned response item
    • "message": string The message of the canned response item
    • "formatted_message": string (optional) The message of the canned response item filled in with the details of the contact.
    • "type": string The type of the canned response item
      • Possible values: "text", "csat", "nps", "buttons", "flow", "richtext", "messagetemplate", "form", "authentication", "timepicker", "applink", "pay"
    • "labels": array (optional) The list of labels of the canned response item
    • "images": array (optional) The list of images of the canned response item
    • "folder":
      • {
        • "id": string (optional) The ID of the folder a canned response is part of
        • "name": string (optional) The ID of the folder a canned response is part of
        }
    • "should_show_in_inbox": boolean Whether the canned response should be shown in inbox
    • "matching_tags": array When tags are specified, this canned response will only be suggested when replying to mentions that have any of the specified (smart) tags.
    • "data": … (optional) Data for canned response depending on type
    }

canned_response_folder

  • {
    • "id": integer The ID of the folder
    • "name": string The name of the folder
    • "updated_by": integer User that last updated the folder
    • "created_at": integer UNIX Timestamp (in UTC) when the folder was created
    • "updated_at": integer UNIX Timestamp (in UTC) when the folder was updated
    }

case_conversation

  • {
    • "case": Object: mention Details about the case itself.
    • "linked_mentions": [] All mentions in this case.
    • "contact": Object: contact (optional) More details about the user this case is with (for auto created cases, not manual cases). Contains e.g. any custom attributes added for this contact.
    }

clarabridge_properties

Identifying properties associated with a cxa document.

  • {
    • "document_id": integer Document id
    • "project_id": integer Project id
    • "content_provider_id": integer Content provider Id
    • "master_account_id": integer Master account id
    • "account_id": integer Account id
    }

clicked_button

  • {
    • "id": string ID of the clicked button.
    • "label": string Label of the clicked button.
    • "payload": string Payload of the clicked button.
    }

connectedprofile

  • {
    • "id": integer Qualtrics Social Connect Specific Id for this connected profile.
    • "type": string Type of connected profile. (Also source.service for mentions from this type.)
      • Possible values: "twitter", "facebook", "facebook_ads", "foursquare_venue", "googleplus", "instagram", "instagram_hashtag", "instagram_ads", "linkedin_group", "pinterest", "rss", "youtube", "mixcloud", "telegram_bot", "tripadvisor", "tumblr_blog", "soundcloud", "vimeo", "linkedin_company", "lithium", "yelp_business", "keywordsearch", "mailservice", "telligent_forum", "telligent_conversation", "telligent_blogs", "instagram_business_profile", "instagram_business_profile_hashtag", "wechat", "twilio", "web", "whatsapp", "whatsapp_cloud_api", "viber", "linkedin_company_v2", "apple_business_chat", "gominga_locations", "gominga_apps", "gominga_products", "gominga_shops", "email_mailbox", "ditto_brand", "social_case", "social_document", "ios", "android", "custom", "tiktok"
    • "service_id": string Id of the connected profile on the site.
    • "displayname": string (optional) Display Name of the profile.
    • "username": string (optional) Username of the profile (For Twitter profiles this is the handle.).
    • "avatar": string (optional) Url of avatar image of this connected profile.
    • "provider": string Identification of the source.type field for mentions from this profile.
      • Possible values: "SearchProviderFacebook", "SearchProviderFacebookAds", "SearchProviderTwitter", "SearchProviderGoogle", "SearchProviderGooglePlus", "SearchProviderFoursquare", "SearchProviderInstagram", "SearchProviderInstagramBusinessProfile", "SearchProviderInstagramAds", "SearchProviderInstagramHashtags", "SearchProviderLinkedInGroups", "SearchProviderLinkedInCompanies", "SearchProviderLinkedInCompaniesV2", "SearchProviderRss", "SearchProviderOmgili", "SearchProviderMoreOver", "SearchProviderYahoo", "SearchProviderWordpress", "SearchProviderBing", "SearchProviderYoutube", "SearchProviderCustom", "SearchProviderApi", "SearchProviderPinterest", "SearchProviderMixCloud", "SearchProviderTripadvisor", "SearchProviderTumblr", "SearchProviderVimeo", "SearchProviderSoundCloud", "SearchProviderEmail", "SearchProviderLithium", "SearchProviderYelp", "SearchProviderCase", "SearchProviderDocument", "SearchProviderTelegramBot", "SearchProviderTelligent", "SearchProviderTelligentConversations", "SearchProviderTelligentBlogs", "SearchProviderWeChat", "SearchProviderTwilio", "SearchProviderWeb", "SearchProviderWhatsApp", "SearchProviderWhatsAppCloudApi", "SearchProviderViber", "SearchProviderAppleBusinessChat", "SearchProviderGomingaLocations", "SearchProviderGomingaApps", "SearchProviderGomingaProducts", "SearchProviderGomingaShops", "SearchProviderIos", "SearchProviderAndroid", "SearchProviderTiktok", "SearchProviderTrendiction"
    • "filters":
      • {
        • "postedby": string (optional) Use this in a filter string to filter on messages posted by this profile. (Only available if it's possible for this profile to post messages itself, which eg. is not the case of a LinkedIn Group.)
        • "postedin": string (optional) Use this in a filter string to filter on messages posted on this profile. (Only available if it's possible for users to post messages on the profile.)
        • "profile": string (optional) Use this in a filter string to filter on all profile related messages (posted by, posted in, mentioning the profile, ...). The service_id is the same as the profile identifier in the mention object.
        }
    }

contact

  • {
    • "id": string (optional) Unique Qualtrics Social Connect specific identifier for this contact (unique per account).
    • "name": string (optional) Full name filled in for this contact.
    • "company": string (optional) Company name filled in for this contact.
    • "email": string (optional) Email filled in for this contact (unvalidated, free-text).
    • "phone": string (optional) Phone number filled in for this contact (unvalidated, free-text).
    • "permalink": string Permanent URL to the contact in Qualtrics Social Connect
    • "address":
      • {
        • "city":
          • {
            • "name": string (optional) City filled in for this contact (unvalidated, free-text).
            }
        • "region":
          • {
            • "name": string (optional) Region filled in for this contact (unvalidated, free-text).
            }
        • "country":
          • {
            • "name": string (optional) Country description chosen for this contact (validated).
            • "code": string (optional) Country code for the country chosen for this contact (ISO 3166-1 country code.).
            }
        }
    • "language": string (optional) ISO 639-1 language code chosen for this contact.
    • "timezone": string (optional) PHP Timezone identifier of the chosen timezone for this contact.
    • "comments": string (optional) Free text area for notes about contact.
    • "socialprofiles": [
      • {
        • "type": string Type of service the social profile is from.
          • Possible values: "twitter", "facebook", "facebook_ads", "foursquare_venue", "googleplus", "instagram", "instagram_hashtag", "instagram_ads", "linkedin_group", "pinterest", "rss", "youtube", "mixcloud", "telegram_bot", "tripadvisor", "tumblr_blog", "soundcloud", "vimeo", "linkedin_company", "lithium", "yelp_business", "keywordsearch", "mailservice", "telligent_forum", "telligent_conversation", "telligent_blogs", "instagram_business_profile", "instagram_business_profile_hashtag", "wechat", "twilio", "web", "whatsapp", "whatsapp_cloud_api", "viber", "linkedin_company_v2", "apple_business_chat", "gominga_locations", "gominga_apps", "gominga_products", "gominga_shops", "email_mailbox", "ditto_brand", "social_case", "social_document", "ios", "android", "custom", "tiktok"
        • "service_id": string Service specific ID of the social profile.
        • "username": string (optional) Handle, username or nickname of the social profile.
        • "displayname": string (optional) Full name or name as shown on social service.
        • "avatar": string (optional) Url of avatar image for this social profile.
        • "url": string (optional) Url of the social profile.
        • "location": string (optional) Textual version of social profile's location.
        • "bio": string (optional) Profile's biography or profile description.
        • "counts": [
          • {
            • "description": string Description of the counter
            • "value": integer The value of the counter
            }
          • {
            • "description": string Description of the counter
            • "value": integer The value of the counter
            }
          • …
          ] (optional)
        • "action_links": [] (optional) Action links define what actions are possible on this social profile and what links for it are.
        }
      • {
        • "type": string Type of service the social profile is from.
          • Possible values: "twitter", "facebook", "facebook_ads", "foursquare_venue", "googleplus", "instagram", "instagram_hashtag", "instagram_ads", "linkedin_group", "pinterest", "rss", "youtube", "mixcloud", "telegram_bot", "tripadvisor", "tumblr_blog", "soundcloud", "vimeo", "linkedin_company", "lithium", "yelp_business", "keywordsearch", "mailservice", "telligent_forum", "telligent_conversation", "telligent_blogs", "instagram_business_profile", "instagram_business_profile_hashtag", "wechat", "twilio", "web", "whatsapp", "whatsapp_cloud_api", "viber", "linkedin_company_v2", "apple_business_chat", "gominga_locations", "gominga_apps", "gominga_products", "gominga_shops", "email_mailbox", "ditto_brand", "social_case", "social_document", "ios", "android", "custom", "tiktok"
        • "service_id": string Service specific ID of the social profile.
        • "username": string (optional) Handle, username or nickname of the social profile.
        • "displayname": string (optional) Full name or name as shown on social service.
        • "avatar": string (optional) Url of avatar image for this social profile.
        • "url": string (optional) Url of the social profile.
        • "location": string (optional) Textual version of social profile's location.
        • "bio": string (optional) Profile's biography or profile description.
        • "counts": [
          • {
            • "description": string Description of the counter
            • "value": integer The value of the counter
            }
          • {
            • "description": string Description of the counter
            • "value": integer The value of the counter
            }
          • …
          ] (optional)
        • "action_links": [] (optional) Action links define what actions are possible on this social profile and what links for it are.
        }
      • …
      ]       A list of social profiles coupled to this contact.
    • "tags": array (optional) Array of strings; (smart) tags added to this contact.
    • "customattributes": [
      • {
        • "id": integer Unique Id of the custom attribute
        • "name": string Name of the custom attribute
        • "type": string Type of custom attribute
          • Possible values: "numeric", "string", "enum", "boolean"
        • "allowed_values": array (optional) List of allowed values (for type `enum`). (Only returned when fetching custom attributes definitions, not when returning custom attributes of a contact.
        • "value": … The value of the the custom field for a certain contact. (Only set when returning contacts, not when returning custom attribute definitions.)
        }
      • {
        • "id": integer Unique Id of the custom attribute
        • "name": string Name of the custom attribute
        • "type": string Type of custom attribute
          • Possible values: "numeric", "string", "enum", "boolean"
        • "allowed_values": array (optional) List of allowed values (for type `enum`). (Only returned when fetching custom attributes definitions, not when returning custom attributes of a contact.
        • "value": … The value of the the custom field for a certain contact. (Only set when returning contacts, not when returning custom attribute definitions.)
        }
      • …
      ] (optional)       A list of extra custom fields for this contact
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the contact was first created.
        • "updated": integer UNIX Timestamp (in UTC) of when the contact was last updated.
        }
    • "action_links": [] (optional) Action links define what actions are possible on this contact.
    }

contact_customattribute

  • {
    • "id": integer Unique Id of the custom attribute
    • "name": string Name of the custom attribute
    • "type": string Type of custom attribute
      • Possible values: "numeric", "string", "enum", "boolean"
    • "allowed_values": array (optional) List of allowed values (for type `enum`). (Only returned when fetching custom attributes definitions, not when returning custom attributes of a contact.
    • "value": … The value of the the custom field for a certain contact. (Only set when returning contacts, not when returning custom attribute definitions.)
    }

context

  • {
    • "id": string The ID of the context item object
    • "type": string The type of the context item object
      • Possible values: "mention", "note", "assign_note"
    • "parent_id": user The ID of the context_item that is the parent of this item
    • "object": The object with the detailed information (schema defined by type)
    }

crisis_event

  • {
    • "id": string The unique identifier of the playbook run
    • "name": string The name of the playbook run
    • "created_at": integer UNIX timestamp (in UTC) when the plan was activated
    • "completed_todo_items": [] (optional) The list of to-do items that are marked as done
    }

crisis_event_completed_todo

  • {
    • "id": string The unique identifier of the to-do item
    • "completed_by": Object: user (optional) The user who marked the to-do item as done
    • "completed_at": integer UNIX Timestamp (in UTC) when the to-do item was marked as done
    }

crisis_plan

  • {
    • "id": string The unique identifier of the plan
    • "name": string The name of the plan
    • "account_id": integer The account ID of the plan
    • "summary": array The summary of the plan
    • "description": string The description of the plan
    • "type": string The type of the plan (severity)
      • Possible values: "error", "warning", "info", "success"
    • "instructions": string The instructions of the plan
    • "instructions_html": string The instructions of the plan with formatted HTML links
    • "coordinators": [] (optional) The list of coordinators of the plan
    • "todo_items": [] (optional) The to-do items of the plan
    • "is_active": boolean Whether the plan is currently active
    • "active_event": Object: crisis_event (optional) The active playbook run of the playbook (if currently active)
    • "created_at": integer UNIX timestamp (in UTC) when the plan was created
    • "updated_at": integer UNIX timestamp (in UTC) when the plan was last updated
    • "action_links": actionlink These action links include one or more links back to the API with a list of allowed actions for the logged-in user.
    }

crisis_plan_todo

  • {
    • "id": string The unique identifier of the to-do
    • "description": string The to-do description
    • "description_html": string The to-do description with formatted HTML links
    • "assignee": Object: user (optional) The to-do assignee (if the task is assigned)
    • "action_links": [] These action links include a link back to the API endpoint to update the status of a task.
    }

cursor_list

This is a generic object that's used where cursored resultsets are returned.

  • {
    • "data": [
      • {Object: …}
      • {Object: …}
      • …
      ]
    • "next":
      • {
        • "url": string (optional) API url to previous page in results (if any).
        • "count": integer (optional) How much results can you expect when using the next url
        }
    }

dashboard

  • {
    • "id": integer Qualtrics Social Connect Specific Id for this dashboard.
    • "name": string Name of this dashboard.
    • "description": string (optional) Description of this dashboard.
    • "components": [] (optional) List of widgets.
    }

dashboard_widget

  • {
    • "id": integer Qualtrics Social Connect Specific Id for this widget.
    • "name": string The name of the dashboard widget.
    • "position":
      • {
        • "column": integer The column this dashboard widget is positioned on (on a grid of 6 columns).
        • "row": integer The row this dashboard widget is positioned on.
        }
    • "size":
      • {
        • "width": integer The width of this dashboard widget. Values 1 to 6 (grid of 6 columns).
        • "height": integer The height of this dashboard widget. 1 = about 150px in Qualtrics Social Connect.
        }
    • "data": … Data of the specific widget. (Note: Structure depends on type of widget!)
    }

entity_hashtag

  • {
    • "string": string Matching hashtag
    • "indices": array Start and end index of matching string in the message of mention
    • "text": string Matching hashtag without the symbol
    • "filter": string Filter string to use when filtering mentions for this hashtag
    • "url": string Clickthrough url for the entity
    }

entity_url

  • {
    • "string": string Matching url
    • "indices": array Start and end index of matching string in the message of mention
    • "url": string Clickthrough url for the entity
    • "short_url": string Shortened url
    • "long_url": string Lengthened version of the short_url
    • "display_url": string Shortened version of the long_url field
    }

entity_user_mention

  • {
    • "string": string Matching user
    • "indices": array Start and end index of matching string in the message of mention
    • "service": string Service type of mentioned user
    • "screen_name": string Display name of the user
    • "filter": string Filter string to use when filtering mentions for this user
    • "url": string Clickthrough url for the entity
    }

extra_field

  • {
    • "id": string The ID of the data field
    • "name": string The attribute name of the data field
    • "value": string The value of the data field
    }

facet

  • {
    • "keys": [
      • {
        • "id": Unique identifier of the key.
        • "text": Textual representation of the key.
        • "html": HTML representation of the key.
        }
      • {
        • "id": Unique identifier of the key.
        • "text": Textual representation of the key.
        • "html": HTML representation of the key.
        }
      • …
      ]       For a table, the keys represent columns. For a chart, the keys typically represent X-axis.
    • "segments": [
      • {
        • "id": Unique identifier of the segment.
        • "text": Textual representation of the segment.
        • "html": HTML representation of the segment.
        }
      • {
        • "id": Unique identifier of the segment.
        • "text": Textual representation of the segment.
        • "html": HTML representation of the segment.
        }
      • …
      ]       For a table, the segments represent rows. For a chart, the segments typically represent different series of the chart.
    • "data": [
      • array Numeric array of values per segment.
      • array Numeric array of values per segment.
      • …
      ]
    }

facetdefinition

This object describes a data facet. It's used for defining a statistical data API-call. Useful for showing charts or summary tables about your data.

  • {
    • "key":
    • "value":
      • {
        • "field": string (optional) The type of calculation to use as Y-axis/cell value for the chart.
          • Possible values: "mentions", "rating", "author_id_cardinality", "followers", "response_time", "resolve_time", "assign_time", "first_action_time"
        }
    • "segmentation":
      • {
        • "field": string (optional) The mention property/field to compare/segment. (Different rows in a table, series in a chart.)
          • Possible values: "message.language", "message.sentiment", "message.type", "message.entities.video", "message.entities.photo", "message.entities.url", "message.entities.domain", "hashtag", "author.name", "source.category", "category_parentsonly", "source.domain", "source.profile", "source.profile.postedby", "source.profile.postedin", "source.application", "location.continent", "location.country", "region_state", "location.city", "location.region", "topic.id", "topic.keywords", "saved_segmentations", "custom"
        • "field_values": array (optional) Custom segmentation. If you choose "custom" as "segmentation.field", supply an array of filter query strings to use for the segmentation.
        • "size": integer (optional) The amount of different segments you want.
        }
    • "type": string (optional) The source data type to use for this facet.
      • Possible values: "mentions", "cases", "insights"
    }

filter_suggestion

  • {
    • "name": string The essence of the filter formulated in a name.
    • "filter": string The value that should be passed to the filter-parameter in the inbox.
    }

handover

  • {
    • "owner": owner
    • "agent_available": boolean If any agents were online when the handover happened.
    }

history_item

  • {
    • "id": integer Unique identifier of the change.
    • "type": string Type of change.
      • Possible values: "project_add", "project_edit", "project_delete", "query_add", "query_edit", "query_delete", "user_add", "user_edit", "user_delete", "query_connectedservice_add", "query_connectedservice_delete", "account_plan_edit", "user_enable", "user_disable", "account_volume_warning", "account_volume_blocked", "account_volume_reset", "mention_delete", "custom_error", "user_custom_role_add", "user_custom_role_edit", "user_custom_role_delete", "automation_rule_add", "automation_rule_edit", "automation_rule_delete", "saved_search_add", "saved_search_edit", "saved_search_delete", "chart_template_add", "chart_template_edit", "chart_template_delete", "project_demodata_add", "project_demodata_edit", "project_demodata_delete", "dashboard_add", "dashboard_edit", "dashboard_delete", "dashboard_component_add", "dashboard_component_edit", "dashboard_component_delete", "cannedresponses_add", "cannedresponses_edit", "cannedresponses_delete", "cannedrespones_copy", "cannedresponses_folder_add", "cannedresponses_folder_edit", "cannedresponses_folder_delete", "cannedresponses_folder_change", "cannedresponses_status_change", "account_tag_add", "account_tag_edit", "account_tag_delete", "account_integration_add", "account_integration_edit", "account_integration_delete", "mention_restore", "account_integration_restore", "account_customfield_add", "account_customfield_edit", "account_customfield_delete", "account_connectedservice_add", "account_connectedservice_delete", "service_mention_delete", "mailbox_add", "mailbox_edit", "mailbox_delete", "mailbox_folder_add", "mailbox_folder_edit", "mailbox_folder_delete", "service_resolve_all", "mailbox_folder_watchdog_add", "mailbox_folder_watchdog_edit", "mailbox_folder_watchdog_delete", "account_businesshoursschedules_add", "account_businesshoursschedules_edit", "account_businesshoursschedules_delete", "account_businesshoursschedules_holiday_add", "account_businesshoursschedules_holiday_delete", "account_teams_add", "account_teams_edit", "account_teams_delete", "account_teams_user_add", "account_teams_user_delete", "automation_rule_status", "project_restore", "query_restore", "user_role_change", "user_businesshours_change", "query_connectedservice_edit", "security_user_locked", "security_user_unlocked", "automation_rule_restore", "account_connectedservice_edit", "dashboard_restore", "dashboard_component_restore", "query_mention_add", "security_settings_changed", "publishingguideline_add", "publishingguideline_edit", "publishingguideline_delete", "publishingguideline_status_change", "query_cxa_stream_add", "query_cxa_stream_delete", "query_cxa_stream_edit", "query_stream_edit", "account_tag_archive", "account_tag_unarchive", "account_crisis_plans_add", "account_crisis_plans_edit", "account_crisis_plans_delete", "account_crisis_plans_restore", "account_profilemanager_theme_add", "account_profilemanager_theme_edit", "account_profilemanager_theme_delete", "account_profilemanager_scheduled_settings_add", "account_profilemanager_scheduled_settings_delete", "account_profilemanager_scheduled_settings_edit", "account_profilemanager_twitter_profile_edit", "account_twitter_custom_profile_add", "account_twitter_custom_profile_delete", "account_twitter_custom_profile_terms_confirmed", "cannedresponses_add_label", "cannedresponses_remove_labels", "account_social_profiles_group_add", "account_social_profiles_group_edit", "account_social_profiles_group_delete", "connectedservice_expired", "query_connectedservice_auth_refresh", "account_custom_badges_add", "account_custom_badges_edit", "account_custom_badges_delete", "saved_search_restore", "account_email_template_edit", "account_delete_contact_details", "account_cxa_integration_add", "account_cxa_integration_edit", "account_cxa_integration_delete", "account_cxa_integration_start_dates_add", "account_cxa_integration_start_dates_edit", "account_cxa_integration_sync_tags", "account_cxa_integration_sync_attributes", "account_hardlocking_edit", "account_whitelabel_edit", "auto_case_creation_rule_add", "auto_case_creation_rule_edit", "auto_case_creation_rule_delete", "auto_case_creation_rule_restore", "achievements_profile_pages", "cannedresponses_action_card_edit", "cannedresponses_condition_card_edit", "account_data_retention_schedule_edit", "automation_recipe_add", "automation_recipe_delete", "automation_recipe_edit", "automation_recipe_restore", "account_whatsapp_business_add", "query_cxa_system_disabled", "account_premium_volume_warning", "account_premium_volume_blocked", "account_saved_segmentations_add", "account_saved_segmentations_edit", "account_saved_segmentations_delete", "mailbox_folder_workload_watchdog_add", "mailbox_folder_workload_watchdog_edit", "mailbox_folder_workload_watchdog_delete"
    • "description": string Text describing the change.
    • "topic":
      • {
        • "id": integer (optional) ID of the topic this change is related to.
        • "name": string (optional) Name of the topic this change is related to.
        }
    • "project":
      • {
        • "id": integer (optional) ID of the project this change is related to.
        • "name": string (optional) Name of the project this change is related to.
        }
    • "user":
      • {
        • "id": integer (optional) ID of the user who did this change. Not available if anonymous change/change by Qualtrics Social Connect system.
        • "name": string (optional) Name of the user who did this change.
        • "email": string (optional) Email of the user who did this change.
        }
    • "ip": string (optional) IP of where the change was made from. (Only available since January 2015.)
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the change was made in Qualtrics Social Connect.
        }
    }

language

  • {
    • "code": string ISO 639-1 language code.
    • "name": string Textual representation of the language, in English.
    }

location

  • {
    • "coordinates":
      • {
        • "longitude": float (optional)
        • "latitude": float (optional)
        }
    • "city":
      • {
        • "name": string (optional)
        • "timezone": string (optional)
        • "population": integer (optional)
        }
    • "region":
      • {
        • "name": string (optional)
        • "timezone": string (optional)
        • "population": integer (optional)
        }
    • "country":
      • {
        • "code": string ISO 3166-1 country code.
        • "name": string
        • "timezone": string
        • "population": integer (optional)
        }
    }

location_details

  • {
    • "location_id": string (optional) ID of the location
    • "location_name": string (optional) Name of the location
    • "locationUrl": string (optional) URL of the location
    • "locationAddress": string (optional) Address of the location
    }

mailbox

  • {
    • "key": string Identifier of the mailbox
    • "name": string Name of the mailbox
    • "folders": [
      • {
        • "key": string Identifier of the folder in the mailbox
        • "name": string Name of the folder
        • "data_type": string Describes the type of data that is in this folder
          • Possible values: "mentions", "publisher"
        • "topics": array List of topic id's
        • "filter": string Filter string
        • "action_links": [] These action links include a link back to the API endpoint to fetch the mentions in this folder (with the right arguments).
        • "subfolders": array (optional) Possible subfolders (these have the same structure as folders)
        }
      • {
        • "key": string Identifier of the folder in the mailbox
        • "name": string Name of the folder
        • "data_type": string Describes the type of data that is in this folder
          • Possible values: "mentions", "publisher"
        • "topics": array List of topic id's
        • "filter": string Filter string
        • "action_links": [] These action links include a link back to the API endpoint to fetch the mentions in this folder (with the right arguments).
        • "subfolders": array (optional) Possible subfolders (these have the same structure as folders)
        }
      • …
      ]       A list of folders for this mailbox.
    }

mention

This object represents a single mention as tracked by Qualtrics Social Connect.
For Twitter, YouTube and TikTok data we only return Qualtrics Social Connect specific data together with the identifiers from the platform (e.g. Tweet ID for Twitter). We do this to enforce that any use of data obtained via us is according to these services' Terms.
Read more: Twitter API Terms, Youtube API Terms, TikTok API Terms Connect FAQ.

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this mention (unique per topic).
    • "unique_id": string Qualtrics Social Connect specific Identifier for this mention.
    • "author":
      • {
        • "name": string (optional) Username or handle of the author of the mention.
        • "fullname": string (optional) Full name of the author of the mention.
        • "id": string (optional) Service specific identifier of the author (eg. Twitter UID).
        • "url": string (optional) Url to the profile page of the author.
        • "img": string (optional) Url to the avatar of the author.
        • "managed": boolean (optional) Is the author of the mention a connected stream in Qualtrics Social Connect.
        • "tags": array (optional) Array of strings; tags added to the author of this mention.
        }
    • "original_author":
      • {
        • "name": string (optional) Username or handle of the original author of the mention. (In case this is a retweet, repin, ...)
        • "fullname": string (optional) Full name of the original author of the mention.
        • "id": string (optional) Service specific identifier of the original author (eg. Twitter UID).
        • "url": string (optional) Url to the profile page of the original author.
        • "img": string (optional) Url to the avatar of the original author.
        }
    • "message":
      • {
        • "title": string (optional)
        • "content": string
        • "stripped_content": string (optional)
        • "entities": Entities found in the message's content field. (Only available for allowlisted applications.)
        • "attachments": [] (optional)
        • "language": string ISO 639-1 language code of the language this message is in.
        • "sentiment": string Any of positive, negative, neutral or unset.
        • "type": string (optional) Type of message.
          • Possible values: "post", "privatemessage", "video", "checkin", "photo", "text", "quote", "link", "chat", "audio", "email", "review", "applause", "like", "retweet", "shared", "repin", "user_favorite", "reblog", "engagement", "comment", "reply", "tips", "question", "answer", "postcard", "listed", "case", "live_chat", "document", "user_tweet", "user_mention", "normal", "other"
        }
    • "source":
      • {
        • "category": string Category this mention can be classified under.
          • Possible values: "social", "social_videos", "social_photos", "microblogs", "conversations", "forums", "blogs", "podcasts", "comments", "news", "news_academic", "news_consumer", "news_corporate", "news_government", "news_journal", "news_local", "news_national", "news_organisation", "news_presswire", "news_trade", "wikis", "reviews", "qa", "locations", "apps", "products", "shops", "classifieds", "email", "case"
        • "service": string What "connected service" source the mention is coming from.
          • Possible values: "twitter", "facebook", "facebook_ads", "foursquare_venue", "googleplus", "instagram", "instagram_hashtag", "instagram_ads", "linkedin_group", "pinterest", "rss", "youtube", "mixcloud", "telegram_bot", "tripadvisor", "tumblr_blog", "soundcloud", "vimeo", "linkedin_company", "lithium", "yelp_business", "keywordsearch", "mailservice", "telligent_forum", "telligent_conversation", "telligent_blogs", "instagram_business_profile", "instagram_business_profile_hashtag", "wechat", "twilio", "web", "whatsapp", "whatsapp_cloud_api", "viber", "linkedin_company_v2", "apple_business_chat", "gominga_locations", "gominga_apps", "gominga_products", "gominga_shops", "email_mailbox", "ditto_brand", "social_case", "social_document", "ios", "android", "custom", "tiktok"
        • "type": string What source the mention is coming from. (Internal name for filtering.)
          • Possible values: "SearchProviderFacebook", "SearchProviderFacebookAds", "SearchProviderTwitter", "SearchProviderGoogle", "SearchProviderGooglePlus", "SearchProviderFoursquare", "SearchProviderInstagram", "SearchProviderInstagramBusinessProfile", "SearchProviderInstagramAds", "SearchProviderInstagramHashtags", "SearchProviderLinkedInGroups", "SearchProviderLinkedInCompanies", "SearchProviderLinkedInCompaniesV2", "SearchProviderRss", "SearchProviderOmgili", "SearchProviderMoreOver", "SearchProviderYahoo", "SearchProviderWordpress", "SearchProviderBing", "SearchProviderYoutube", "SearchProviderCustom", "SearchProviderApi", "SearchProviderPinterest", "SearchProviderMixCloud", "SearchProviderTripadvisor", "SearchProviderTumblr", "SearchProviderVimeo", "SearchProviderSoundCloud", "SearchProviderEmail", "SearchProviderLithium", "SearchProviderYelp", "SearchProviderCase", "SearchProviderDocument", "SearchProviderTelegramBot", "SearchProviderTelligent", "SearchProviderTelligentConversations", "SearchProviderTelligentBlogs", "SearchProviderWeChat", "SearchProviderTwilio", "SearchProviderWeb", "SearchProviderWhatsApp", "SearchProviderWhatsAppCloudApi", "SearchProviderViber", "SearchProviderAppleBusinessChat", "SearchProviderGomingaLocations", "SearchProviderGomingaApps", "SearchProviderGomingaProducts", "SearchProviderGomingaShops", "SearchProviderIos", "SearchProviderAndroid", "SearchProviderTiktok", "SearchProviderTrendiction"
        • "id": string (optional) Identification of this message on the service it's from. (Eg. the tweet ID for a Twitter message.)
        • "in_reply_to_message_id": string (optional) Unique identifier of the message this message is a reply/comment on.
        • "thread_id": string (optional) Unique identifier of the top-most post this is a reply to. (If the current mention is a reply to a comment, that is a comment on a post, this value will be the ID of the top-post. Not available for all sources.)
        • "domain": string
        • "url": string (optional) The URL of the message on the service it's from. (E.g. the link to the comment on Facebook itself.)
        • "application": string (optional) Application or client this message was posted with.
        • "profile": string (optional) Identifier of the profile this mention was found on. The identifier is the service_id. Eg. the ID of the Facebook page, the ID of the Twitter profile, ...
        • "profile_name": string (optional) Name/title of the profile/category/forum this message was posted on. (eg. the name of the Facebook page, Forum, ...)
        • "identifiers":
        • "sender": source_sender (optional) Who or what sent the mention.
        }
    • "location":
      • {
        • "continent": string (optional) Continent code
        • "country": string (optional) ISO 3166-1 country code.
        • "city": string (optional) Full name of the city.
        • "region": string (optional)
        • "longitude": float (optional)
        • "latitude": float (optional)
        }
    • "tags": array (optional) Array of strings; (smart) tags added to this mention.
    • "topic":
      • {
        • "id": integer
        • "name": string
        }
    • "project":
      • {
        • "id": integer
        • "name": string
        }
    • "status": string Status corresponds to the stage in the workflow a mention/case is currently in.
      • Possible values: "done", "pending", "new"
    • "permalink": string Qualtrics Social Connect specific-url unique to this mention.
    • "assignment":
      • {
        • "user_ids": array DEPRECATED (in favor of assignees): Array of (integer) UIDs this mention is assigned to.
        • "team_ids": array DEPRECATED (in favor of assignees): Array of (integer) team IDs this mention is assigned to.
        • "comments": string The comment on the most recent assignment.
        }
    • "assignees": []
    • "actions": []
    • "action_links": [] Action links define what actions are possible on this mention and what links for it are.
    • "handled_by": {
      • "type": string
        • Possible values: "bot", "flow"
      • "flow_id": string (optional) If type = flow, this will be the identifier of the Canned Response Flow.
      } (optional)       Contains the type of how the mention was handled (bot, flow, ..) and if relevant the corresponding flow id.
    • "timestamps":
      • {
        • "response_time": integer (optional) The time between date.published and the first reply (if any), in seconds.
        • "response_time_during_bh": integer (optional) The time (during business hours) between date.published and the first reply (if any), in seconds.
        • "resolve_time": integer (optional) The time between date.published and the first resolve date (if any), in seconds.
        • "resolve_time_during_bh": integer (optional) The time (during business hours) between date.published and the first resolve date (if any), in seconds.
        • "handle_time": integer (optional) The total time spent handling this message, in seconds.
        • "unresolved_time": integer (optional) The total time a case has been in unresolved status.
        • "unresolved_time_during_bh": integer (optional) The total time (during business hours) a case has been in unresolved status.
        • "pending_time": integer (optional) The total time a case has been in pending status.
        }
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the post was indexed by Qualtrics Social Connect.
        • "published": integer (optional) UNIX Timestamp (in UTC) of when the post was published.
        }
    • "priority": priority (optional)
    • "extra_attributes": [] (optional) Extra fields with details about the mention.
    • "part_of_cases":
      • {
        • "mention_identifiers": [] (optional) If this mention is part of one or more cases, this array will contain the identifiers of those cases.
        }
    • "todos": [] (optional) An aggregated list of to-dos originating from attached notes.
    • "buttons": [] (optional) A list of buttons from the sent multiple choice question.
    • "clicked_buttons": [] (optional) A list with clicked buttons the user selected from the sent multiple choice question.
    • "service_details": service_details (optional) A list of service details
    }

mention_action

  • {
    • "user":
      • {
        • "id": string UID of the user who did the action.
        • "name": string Full name of the user who did the action.
        }
    • "type": string Textual representation of the type of action.
      • Possible values: "tag", "assign", "status", "note", "reply", "sentiment", "like", "retweet", "favorite", "automationtriggered", "property", "email", "delete_on_service", "hide_on_service", "create_case_on_service", "block_on_service", "triggered_by_alert", "case_linked", "case_unlinked", "post_created", "upvote", "verify", "suggest", "post_awaitingapproval_created", "post_draft_created", "case_created", "csat_reply", "nps_reply", "handover_on_service", "multiple_choice", "rebut", "flow", "quote_tweet", "erase_pii_content", "updated", "mark_todo"
    • "description": string Textual description of the action taken.
    • "details": string (optional) Extra information (eg. the note when "Note Added" action)
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC).
        }
    • "metadata": … (optional) The metadata of the action (E.g. for `status` that will contain done, new, pending, ...)
    }

mention_assignee

  • {
    • "id": string Unique identifier of the assignee
    • "type": string
      • Possible values: "user", "team"
    • "display_name": string Display name of assignee
    }

mention_attachment

  • {
    • "type": string Type of the attachment
      • Possible values: "other", "photo", "photo_gif_frame", "url", "place", "audio", "file", "video", "web_url", "nps_answer", "nps_question", "csat_question", "csat_answer", "dm_deeplink", "rating_answer", "product", "unsupported"
    • "url": string (optional) Url of the attachment (the link, the photo, ...)
    • "title": string (optional)
    • "image": string (optional) Url of the image of the attachment
    • "description": string (optional)
    • "caption": string (optional)
    • "question": string (optional) For type `csat` & `nps`: ID of question.
    • "id": integer (optional) The ID of the image of the attachment
    • "content": … (optional) The content of the attachment, if relevant. (E.g. for `dm_deeplink` this will be `true`, for type `csat_answer` & `nps_answer` this will be the given score, for type `csat_question` & `nps_question` this will be the ID of the question variant.)
    }

mention_identifier

This object represents the identifiers of a single mention as tracked by Qualtrics Social Connect. This object will not contain any details

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this mention (unique per topic).
    • "unique_id": string Qualtrics Social Connect specific Identifier for this mention.
    • "permalink": string Qualtrics Social Connect specific URL, unique to this mention.
    • "topic":
      • {
        • "id": integer
        }
    }

message

  • {
    • "level": string (optional) Is this an error (non-fatal) or a warning?
      • Possible values: "error", "info", "success", "warning"
    • "code": string (optional) This is for non fatal error & warning messages. (Eg. when using deprecated methods.)
    • "description": string (optional)
    • "details": array (optional) Extra details about the error that occured.
    • "show_user": boolean (optional) Should you show this message to the user?
    }

note

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this note.
    • "content": string The content of the note
    • "added_by": user
    • "date":
      • {
        • "added": integer (optional) UNIX Timestamp (in UTC) of when the note was added.
        }
    }

owner

  • {
    • "name": string Name of an application acting as owner.
    • "type": string The type indicates if the service is managed by Qualtrics Social Connect (internal) or by a 3rd party (external).
      • Possible values: "internal", "external"
    }

paged_list

This is a generic object that's used where paginated resultsets are returned.

  • {
    • "count": integer Total count of results (across all pages).
    • "data": [
      • {Object: …}
      • {Object: …}
      • …
      ]
    • "paging":
      • {
        • "next_url": string (optional) Absolute API url to next page in results (if any). (Some paged lists are limited in how many pages you can request for performance reasons; `next_url` will be empty if you've reached the last available page.)
        • "previous_url": string (optional) Absolute API url to previous page in results (if any).
        }
    }

priority

  • {
    • "id": integer The priority of a case (0 to 10).
    • "name": string The priority level of a case.
    • "color": string The color of the priority level of a case.
    }

product_details

  • {
    • "product_id": string (optional) ID of the product
    • "product_name": string (optional) Name of the product
    }

profile_group

  • {
    • "id": string Unique identifier for the profile group.
    • "name": string Name of the profile group.
    • "profiles_count": integer The total number of profiles in this group.
    • "date":
      • {
        • "updated": integer UNIX Timestamp (in UTC) of when the group was last updated.
        • "added": integer UNIX Timestamp (in UTC) of when the group was first created.
        }
    • "profiles": [] The list of profiles in this group.
    }

project

  • {
    • "id": integer Unique identifier of the project.
    • "name": string
    • "visible": boolean Is this project visible to the user?
    • "topics": []
    }

publisher_mention

This object represents a collection of posts from the publisher.

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this publisher mention.
    • "author":
    • "message":
      • {
        • "title": string (optional)
        • "content": string
        • "type": string (optional) Type of message (source specific, eg. "retweet", or "like").
        • "attachments": [] (optional)
        • "permalink": string Qualtrics Social Connect specific-url unique to this mention.
        • "status": string Status of message (eg. "draft", "posted")
        }
    • "assignment":
      • {
        • "user_ids": array Array of UIDs this publisher mention is assigned to.
        • "comments": string The comment on the most recent assignment.
        }
    • "tags": array (optional) Array of strings; (smart) tags added to this mention.
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the post was first created in Qualtrics Social Connect.
        • "published": integer (optional) UNIX Timestamp (in UTC) of the (upcoming) publication date.
        }
    • "action_links": [] Action links define what actions are possible on this publisher mention and what links for it are.
    • "services": [] A list of profiles this post will/is published to.
    • "actions": []
    • "in_reply_to": Object: mention (optional) The mention to which the post is a reply.
    }

publishing_guideline

  • {
    • "id": integer Unique identifier for the Publishing Guideline.
    • "type": string The type of the Publishing Guideline.
      • Possible values: "PRESET", "TEXT"
    • "content": The restricted content of the Publishing Guideline.
    • "arguments": array (optional)
    • "message": string The message of the Publishing Guideline.
    • "level": string The level of warning for a Publishing Guideline.
      • Possible values: "INFO", "WARNING", "BLOCK"
    • "regex": string (optional) Regex to determine if message is according to the Publishing Guideline.
    • "date":
      • {
        • "updated": integer UNIX Timestamp (in UTC) of when the Publishing Guideline was last updated.
        }
    }

rehydration

  • {
    • "id": …
    }

service

  • {
    • "type": string The type of service
    • "service_id": string Service specific ID of this profile
    • "displayname": string Display name of the profile
    • "url": string (optional) Url to the profile
    • "avatar": string (optional) Url of the avatar of this profile
    • "status": string (optional) Indicates if the publisher mention was successfully published on the service. (Only available as part of a publisher_mention object.)
      • Possible values: "success", "failed"
    }

service_details

  • {
    • "type": array
      • Possible values: "location_details", "product_details", "app_details", "shop_details", "author_phone"
    • "optional":
    }

shop_details

  • {
    • "shop_id": string (optional) ID of the shop
    • "shop_name": string (optional) Name of the shop
    }

source_sender

  • {
    • "type": string The type of source
      • Possible values: "user", "flow"
    • "id": string The ID of the source
    • "name": string The name of the source
    }

tag

  • {
    • "id": integer Unique identifier of the tag
    • "tag": string Name of the tag
    • "filter": string Filter string to use when filtering mentions for this tag
    • "color_code": string (optional) rgb() color code for the tag
    • "parent_id": string (optional) Id of the tag's parent
    • "visible": boolean Tag configured as visible or not
    • "category_model_tag": boolean Is the tag belonging to a category model
    • "status": string The status of a tag
      • Possible values: "active", "archived"
    }

team

  • {
    • "id": integer Identifier of the team.
    • "name": integer Name of the team.
    • "show_in_team_performance": boolean Whether or not this team is shown in the team performance section.
    • "users": [
      • {
        • "id": integer Unique identifier of this Qualtrics Social Connect user.
        • "name": string
        • "email": string (optional) (Only if your application has permission for scope 'email')
        • "avatar": string (optional) Url of avatar image for this user
        • "account_role": string (optional) Shows rights of user in the context of an account.
        • "business_hours_schedule_id": string (optional) Unique identifier for the business hours schedule of the Qualtrics Social Connect user.
        • "status": string (optional) Shows the user status.
          • Possible values: "available", "busy", "unavailable"
        • "business_hours_schedule_is_active": boolean (optional) Shows if the current time is within the users' business hours schedule. (Property only set when requesting users in an account context.)
        }
      • {
        • "id": integer Unique identifier of this Qualtrics Social Connect user.
        • "name": string
        • "email": string (optional) (Only if your application has permission for scope 'email')
        • "avatar": string (optional) Url of avatar image for this user
        • "account_role": string (optional) Shows rights of user in the context of an account.
        • "business_hours_schedule_id": string (optional) Unique identifier for the business hours schedule of the Qualtrics Social Connect user.
        • "status": string (optional) Shows the user status.
          • Possible values: "available", "busy", "unavailable"
        • "business_hours_schedule_is_active": boolean (optional) Shows if the current time is within the users' business hours schedule. (Property only set when requesting users in an account context.)
        }
      • …
      ]       List of users that are part of the team.
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the Team was first created.
        • "updated": integer UNIX Timestamp (in UTC) of when the Team was last updated.
        }
    }

to-do

  • {
    • "id": string Qualtrics Social Connect specific Identifier for this to-do.
    • "author": to-do_author The author of the to-do.
    • "text": string The text of the to-do.
    • "assignees": []
    • "status": string The status of a to-do
      • Possible values: "todo", "done"
    • "dateadd": integer UNIX Timestamp (in UTC) of when the to-do was first created.
    • "lastupdate": integer UNIX Timestamp (in UTC) of when the to-do was last updated.
    }

to-do_author

  • {
    • "id": string (optional) Qualtrics Social Connect specific Identifier for the author.
    • "name": string (optional)
    • "email": string (optional)
    }

topic

  • {
    • "id": integer Unique identifier of the topic.
    • "name": string
    • "searchkeywords": (optional) Search keywords
    • "monitoredprofiles": [] (optional)
    }

user

  • {
    • "id": integer Unique identifier of this Qualtrics Social Connect user.
    • "name": string
    • "email": string (optional) (Only if your application has permission for scope 'email')
    • "avatar": string (optional) Url of avatar image for this user
    • "account_role": string (optional) Shows rights of user in the context of an account.
    • "business_hours_schedule_id": string (optional) Unique identifier for the business hours schedule of the Qualtrics Social Connect user.
    • "status": string (optional) Shows the user status.
      • Possible values: "available", "busy", "unavailable"
    • "business_hours_schedule_is_active": boolean (optional) Shows if the current time is within the users' business hours schedule. (Property only set when requesting users in an account context.)
    }

userrole

  • {
    • "id": string Unique identifier for the User Role.
    • "title": string Title of the User Role.
    • "license": string What type of license this User Role is.
      • Possible values: "free", "paying"
    • "permissions": array A list of all the permissions associated with this user role.
      • Possible values: "inbox.read", "mailboxes.update", "inbox.focus_view_only", "inbox.unassigned_resolve_reply", "insights.read", "insights.customcharts.read", "insights.customcharts.update", "usagestatistics.read", "usagestatistics.userdetails.read", "properties.update", "tags.create", "tags.update", "contacttags.update", "status.update", "assignments.update", "sentiment.update", "note.update", "note.delete", "automation.update", "connectedservices.drafts.update", "connectedservices.status.update", "connectedservices.status.reply", "connectedservices.status.like", "connectedservices.status.retweet", "queries.connectservices", "queries.update", "queries.mentions.delete", "queries.mentions.delete.service", "queries.mentions.erasepiiandcontent.update", "queries.mentions.hide.service", "users.update", "adminusers.update", "businesshoursschedules.update", "teams.update", "account.update", "savedsearches.update", "customdashboards.read", "customdashboards.update", "cannedresponses.update", "contacts.read", "contacts.update", "contacts.delete", "customkiosks.update", "whitelabeling.update", "history.read", "export.historyall.read", "api.read", "mobileapps.read", "ipwhitelist.update", "publisher.read", "savedtargeting.update", "accountconnectedservices.update", "contactssettings.update", "settings.read", "security.settings.edit", "security.settings.audit.read", "settings.mention.locking.update", "publishingguidelines.update", "watchdogs.read", "watchdogs.update", "settings.mention.hardlocking.update", "crisisplans.update", "crisisevents.update", "crisiseventstodos.update", "profilemanager.profile.update", "twittercustomprofiles.update", "achievements.update", "customachievements.assign", "customachievements.update", "profilemanager.profilegroups.read", "profilemanager.profilegroups.update", "replysuggestions.read", "socialcases.update", "socialcasesrebuttal.update", "inboxonlyassignedtome.read", "import.update", "domainallowlist.update", "autocasecreationrules.update", "savedsegmentations.update", "inbox.blockcontact.update"
    • "topics": [] A list of topics this role has access too.
    • "date":
      • {
        • "added": integer UNIX Timestamp (in UTC) of when the User Role was created.
        • "updated": integer UNIX Timestamp (in UTC) of when the User ROle was last updated.
        }
    }
©2024 Qualtrics®. All rights reserved.
Stay connected