DevelopersChanges data

import_call_targets

API reference — one of the tools an AI assistant can call on an Avrosh account.

What it does

Add numbers to a DRAFT or paused campaign. Numbers are normalised HERE against `dial_code`, so pass them as they came from the customer's own records rather than reformatting them yourself - and pass the dial code of the country those records belong to, never a guess. Anything already on the do-not-call list is silently left out and returned in `suppressed`: that is correct, do not retry it and do not tell the operator it failed. Rows that could not be read at all come back in `rejected` with a reason. Adding numbers still does not make the campaign runnable - only a human attesting to consent does that.

This is the exact text the model reads before deciding to call.

Parameters

business_idstringrequired

The id returned by list_businesses.

list_idstringrequired

From list_call_lists.

dial_codestringrequired

e.g. '+62'. Used for local-format numbers.

rowsarrayrequired

Up to 1000 per call. Page larger files.

Request

curl -X POST https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"import_call_targets","arguments":{"business_id":"926135ac-487d-4367-8bad-25397d0d4b87","list_id":"cl_2…","dial_code":"+62","rows":[{"phone":"0812-3456-7890","name":"Sari","external_id":"crm-4471"}]}}}'

Response

The result arrives as an MCP content block; the JSON below is what the text field parses to.

{
  "added": 1,
  "duplicate": 0,
  "suppressed": [],
  "rejectedTotal": 0
}

Connecting

Paste the URL into your assistant and log in. Avrosh implements OAuth 2.1, so an MCP client discovers the authorisation server, registers itself, and opens a browser asking you to sign in here. That is the whole setup: nothing to copy, no key to keep, and nothing to rotate later.

https://us.avrosh.com/mcp

For something with no browser to log in with — a cron job, a script, an automation platform — there is a second door: a bearer key made in the dashboard under Docs, shown once because only its hash is stored, and revocable at any time.

curl https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY"

Either way the boundary is the same one: an assistant reaches every business on the account it signed in to, and no others. There are no scopes to configure and nothing to switch on — what bounds it is whose account it is, enforced in the database rather than by a permission anybody sets.