Skip to main content
POST
Connect a new Instagram account

Authorizations

Authorization
string
header
required

Enter your API key: wave_live_<token>

Body

application/json

Create a new Instagram sender account connection.

username
string
required

Instagram username to connect

Required string length: 1 - 64
password
string
required

Instagram account password

Minimum string length: 1
secret
string
required

Instagram 2FA secret (digits, with or without dashes)

Minimum string length: 1
proxy_country_code
string
required

ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB')

Required string length: 2
proxy_city
string
required

City within the proxy country (use GET /accounts/get-cities to list valid values)

Minimum string length: 1

Response

Successful Response

Response shape returned by create and update routes. Profile picture is intentionally omitted because it is null at the moment of create/update — callers should call GET /accounts/{id} to fetch it once Instagram login completes asynchronously.

id
string<uuid>
required

Account ID

username
string
required

Instagram username

setup_status
string
required

Setup status (NOT_STARTED, LOGGEDIN, WARMING_UP, READY, ...)

created_at
string<date-time> | null
updated_at
string<date-time> | null