Manage Phone Numbers

Phone numbers represent the iMessage identities on your connected Macs. Register them in Coop to control which number outgoing messages come from.

Register a phone number

1. Go to Settings > Relays
2. Find the connected Mac whose number you want to register
3. Add the phone number with an optional label (e.g. "Main office", "Support line")

Or via the API:

curl -X POST https://api.coop.example.com/api/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": "+15551234567", "label": "Main office"}'

Send from a specific number

When sending a message, pass fromNumber to choose which number to send from:

{
  "to": "+15559876543",
  "body": "Following up on our call.",
  "fromNumber": "+15551234567"
}

If omitted, Coop uses the default number on whichever Mac processes the message.

Deactivate a number

Deactivating a number stops it from being used for outgoing messages. The number and its message history are preserved.

Go to Settings > Relays and remove the number, or call DELETE /api/v1/phone-numbers/:id.