Skip to content

Import Contacts

Fresh

Batch import contacts to a cloud phone.

URL: https://openapi.geelark.com/open/v1/phone/contacts/importMethod: POST

Request Parameters

ParameterRequiredTypeDescription
idYesstringCloud phone ID
contactsYesarray[ContactObject]Contacts to import

ContactObject

ParameterRequiredTypeDescription
nameYesstringContact name
phoneYesstringPhone number

Request Example

json
{
  "id": "528086321789535232",
  "contacts": [
    { "name": "John", "phone": "+1234567890" },
    { "name": "Jane", "phone": "+0987654321" }
  ]
}

Response

Returns a taskId. Results are delivered via webhook callback (type 14).

json
{
  "traceId": "123456ABCDEF",
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "528715748189668352"
  }
}

Get Import Result

URL: https://openapi.geelark.com/open/v1/phone/contacts/import/resultMethod: POST

ParameterRequiredTypeDescription
taskIdYesstringImport task ID

Error Codes

CodeDescription
42001Cloud phone does not exist
42002Cloud phone is not in running state

GEELark API Documentation - Built with VitePress