Data Portability - Deep Linking Guide

Meta's data portability tools allow users to create transfer requests on Meta's platforms through the Export Your Information (EYI) tool, which provide users granular control over which data is transferred, how often it is transferred, and where it is being transferred to. In most cases this is the preferred user experience, however, there are situations where the user experience is improved by initiating the data transfer using information collected on your platform. For example:

Your platform imports only a specific type of information from an EYI Archive
You want to create an 'Import from Facebook' button to quickly start an EYI transfer to your Photos app

These use cases are supported by the Export Your Information (EYI) tool support for Deep Linking, which you can use to create a custom link with some or all options in the tool pre-selected.

Creating Deep Links

Deep links for EYI must direct users to the Facebook or Instagram Accounts Center EYI page - https://accountscenter.facebook.com/info_and_permissions/dyi, or https://accountscenter.instagram.com/info_and_permissions/dyi.

You can specify options to pre-select in the query parameters of the URL, described by the table below.

Deep Link Query Parameters

Parameters	Values	Format	Required	Description
`source`	`external`	`source=external`	Yes	The source of the link. Must be 'external'.
`account_type`	`0` (Facebook), `1` (Instagram), or `4` (Meta Horizon)	`account_type=value`	Yes	The account type to transfer data from. If more account types become available in future, the corresponding values will be added to this parameter.
`import_service`	Your Service ID `Dropbox`, `GoogleDrive`, ...	`import_service=encoded_uri_component_name`	Yes	Preselects the destination for data transfer.
`redirect_uri`	Any valid URL	`redirect_uri=encoded_uri_component_url`	No	Redirects the user to the provided URL after successfully submitting the transfer request. Whilst not required, this is beneficial so that users complete the journey where they began rather than ending off platform.
`sections`	Enum value `POSTS_YOUR_ACTIVITY`,	`sections[n]=value`	No	Preselects these data types. If the selected data types do not match the chosen account type, they will not be selected. See the table on the Deep Linking Data Parameters page for all valid values.
`format`	`JSON`, `HTML`	`format=value`	No	Preselects the EYI archive data format. Defaults to `HTML`.
`date_range`	`LAST_WEEK`, `LAST_MONTH`, `LAST_3_MONTHS`, `LAST_6_MONTHS`, `LAST_YEAR`, `LAST_3_YEARS`, `ALL_TIME`, `CUSTOM`	`date_range=value`	No	The date range to filter exported data.
`start`	Seconds since unix Epoch	`start=value`	If `date_range=CUSTOM`	The start of the date range to filter exported data, if `date_range=CUSTOM`
`end`	Seconds since unix Epoch	`end=value`	If `date_range=CUSTOM`	The end of the date range to filter exported data, if `date_range=CUSTOM`
`quality`	`LOW`, `MEDIUM`, `HIGH`	`quality=value`	No	The quality of media (photos, videos) included in the transfer.
`schedule_frequency`	`ONE_TIME`, `ONCE_A_MONTH_FOR_SIX_MONTHS`, `ONCE_A_MONTH_FOR_ONE_YEAR`, `ONCE_A_MONTH_FOR_TWO_YEARS`, `ONCE_A_MONTH_FOR_THREE_YEARS`, `ONCE_A_YEAR_FOR_TWO_YEARS`, `ONCE_A_YEAR_FOR_THREE_YEARS`, `ONCE_A_DAY_FOR_THREE_DAYS`, `ONCE_A_DAY_FOR_NINETY_DAYS`, `ONCE_A_DAY_FOR_ONE_YEAR`, `ONCE_A_DAY_FOR_TWO_YEARS`, `ONCE_A_DAY_FOR_THREE_YEARS`, `ONCE_AN_HOUR_FOR_THREE_HOURS`	`schedule_frequency=value`	No	The schedule for a recurring transfer. Defaults to `ONE_TIME`.

Examples

As an example, you could create an EYI Deep Link to:

Transfer from a Facebook account with account_type=0
Transfer a list of friends and other personal information from an EYI archive sections[0]=FRIENDS_V2 and sections[1]=PERSONAL_INFO
Transfer to Google Drive using import_service=GoogleDrive

Combining these parameters gives the link https://accountscenter.facebook.com/info_and_permissions/dyi?source=external&sections[0]=FRIENDS_V2&sections[1]=PERSONAL_INFO&account_type=0&import_service=GoogleDrive.