Imports

The imports endpoint enables you to import and stage contacts data prior to merging with existing contact data. The imports endpoint(s) accepts CSV files with a specific header format, see the CSV imports page for an example of the default template or the LinkedIn integrations page for information about how to download your Linkedin contacts and upload to R0.

View imports

Fetch a list of bulk uploaded imports

GET https://web.r0app.com/api/v1/orgs/:org_id/imports

Returns a paginated list of imports.

Query Parameters

Name	Type	Description
page	Integer	For more info, see the pagination section in the Getting started guide.
limit	Integer	For more info, see the pagination section in the Getting started guide.
include[]	String	If set to deleted all active and deleted records will be returned in the response.

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/imports \
    -X GET \
    -H 'Authorization: Bearer <token>'

View an import

Fetch an import record

GET https://web.r0app.com/api/v1/orgs/:org_id/imports/:import_id

Returns a single import. Please note this endpoint does not include any information about data imported.

Path Parameters

Name	Type	Description
:import_id*	UUID

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/imports/:import_id \
    -X GET \
    -H 'Authorization: Bearer <token>'

Upload an import

Upload an import

POST https://web.r0app.com/api/v1/orgs/:org_id/imports

Upload a CSV file with a formatted list of contacts / contact information.

Request Body

Name	Type	Description
upload*	File
type	String	Optional: when set to linkedin_csv you can import a formatted list of all your contacts from LinkedIn.

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/imports \
    -X POST \
    -H 'Authorization: Bearer <token>' \
    -F 'upload=@example.csv'

Delete an import

NOTE: your import will be deleted from our servers immediately. There is no recourse for this action, proceed with caution. If your contacts have already been imported this will NOT revert changes.

Delete an import

DELETE https://web.r0app.com/api/v1/orgs/:org_id/imports/:import_id

Path Parameters

Name	Type	Description
:import_id*	UUID

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/imports/:import_id \
    -X DELETE \
    -H 'Authorization: Bearer <token>'