List all activity logs

Example Request & Response

curl https://api.intercom.io/admins/activity_logs?created_at_after=489222000&created_at_before=685695600 \\\n-X GET \\\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept: application/json' \\\n-H 'Content-Type: application/json'

Example Errors

HTTP/1.1 404 NOT FOUND\n{\n  \"type\" => \"error.list\",\n  \"request_id\" => nil,\n  \"errors\" => [{\n\t\"code\" => \"parameter_not_found\",\n\t\"message\" => \"Please provide the following parameters: created_at_after\"\n  }]\n}\n
HTTP/1.1 403 RESTRICTED\n{\n  \"type\" => \"error.list\",\n  \"request_id\" => nil,\n  \"errors\" => [{\n\t\"code\" => \"api_plan_restricted\",\n\t\"message\" => \"This feature is not yet available to your app\"\n  }]\n}

You can get a log of activities by all admins in an app by sending a GET request to the URL https://api.intercom.io/admins/activity_logs.

Activity List

AttributeTypeDescription
typestringValue is activity_log.list
activity_logsarrayA list of activity objects
pagesobjectOptional. A pagination object which may be empty, indication no further pages to fetch

Activity Object

AttributeTypeDescription
activity_typestringThe type of activity - see Activity Types & Descriptions below.
activity_descriptionstringA sentence or two describing the activity - see Activity Types & Descriptions below.
metadataobjectAn object containing information on the activity and what it modified
created_attimestampThe time the activity was performed
performed_byobjectAn Admin object of the admin who performed the activity
idstringThe id representing the activity

Activity Types & Descriptions

TypeDescription
admin_assignment_limit_changeA teammate changed their assignment limit
admin_away_mode_changeA teammate changed their away mode and conversation reassignment settings
admin_deletionA teammate was removed from your workspace
admin_deprovisionedA teammate was deprovisioned from your workspace via SCIM
admin_invite_changeThe permissions for a teammate invite were changed
admin_invite_creationA teammate invite was created
admin_invite_deletionA teammate invite was deleted
admin_login_failureA teammate tried to login with the wrong credentials
admin_login_successA teammate logged in successfully
admin_logoutA teammate logged out
admin_password_reset_requestA teammate requested a password reset
admin_password_reset_successA teammate's password was successfully reset
admin_permission_changeThe permissions for a teammate were changed
admin_provisionedA teammate was provisioned on your workspace via SCIM
app_admin_joinA teammate joined your workspace (i.e. accepted your invite)
app_authentication_method_changeYour workspace's authentication methods were changed
app_data_deletionA user or lead was deleted from your workspace
app_data_exportMessage or conversation data was exported from your workspace
app_google_sso_domain_changeYour workspace's Google SSO domain was changed
app_identity_verification_changeYour workspace's identity verification setting was changed
app_name_changeThe name of your workspace was changed
app_outbound_address_changeThe outbound email address was changed for your workspace
app_package_installationAn app package was installed on your workspace
app_package_token_regenerationAn access token for a specific app package was updated
app_package_uninstallationAn app package was uninstalled from your workspace
app_team_creationA team was created
app_team_deletionA team was deleted
app_team_membership_modificationA team's membership was modified
app_timezone_changeAn app package was installed in your workspace
app_webhook_creationA webhook subscription was created
app_webhook_deletionA webhook subscription was deleted
articles_in_messenger_enabled_changeThe Messenger search for articles setting was changed
bulk_deleteUser or lead data was deleted from your workspace
bulk_exportUser or lead data was exported from your workspace
campaign_deletionA campaign was deleted from your workspace
campaign_state_changeA campaign was changed on your workspace
conversation_topic_changeA conversation topic was changed
conversation_topic_creationA conversation topic was created
conversation_topic_deletionA conversation topic was deleted
help_center_settings_changeYour Help Center was turned on or off
inbound_conversations_changeThe Messenger inbound conversations setting was changed
inbox_access_changeThe inbox access setting was changed
message_deletionA team was deleted from your workspace
message_state_changeA message's state was changed
messenger_look_and_feel_changeThe Messenger look and feel setting was changed
messenger_search_required_changeThe Messenger search required setting was changed
office_hours_changeThe office hours setting was changed
role_changeA role was changed
role_creationA role was created
role_deletionA role was deleted
seat_changeA teammate's seat was changed
seat_revokeA teammate's seat was revoked
security_settings_changeYour workspace's security settings were changed
temporary_expectation_changeThe Messenger special notice settings were changed
upfront_email_collection_changeThe Messenger upfront email collection settings were changed
welcome_message_changeThe Messenger welcome message settings were changed

Request Query Parameters

ParameterRequired?Description
created_at_afterYesThe start date that you request data for. It must be formatted as a UNIX timestamp.
created_at_beforeNoThe end date that you request data for. It must be formatted as a UNIX timestamp.

Response

This will return an Activity List which will contain an array titled activity_logs, in turn containing multiple Activity Objects.