Change a member's role, abilities or forms
https://api.app2email.com/v1/{number}/submit/members/{id} Scope: submissions:manage. Not with a sandbox key. Any of name, role, abilities, forms, own_only, see_unassigned, hide_contacts, notify; what is left out stays (400 invalid_member when the body names none). abilities replaces the member's own changes to the role's set: {"delete": false} takes one ability away from a manager. The owner's own row cannot be changed (400 invalid_member).
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270 -
The member's id (GET /submit/members).
e.g.12
Body application/json required
- name stringe.g.
Sam - role string
A named starting set of abilities.
admin: Every ability.manager: note, reply, edit, stage, assign, files, export, delete, run.agent: note, reply, edit, stage, files, run.viewer: Sees submissions, changes nothing.adminmanageragentviewer -
Changes to the role's set: {ability: true or false}. In an update it replaces the member's earlier changes.
note: Write internal notes.reply: Reply to the submitter.edit: Edit answers and internal fields.stage: Change the stage.assign: Assign to anyone (an agent may always take a submission themselves).files: Add and remove files.export: Export.delete: Delete and restore.run: Run manual automations.forms: Manage forms and lists.automations: Manage automations and connections.team: Manage the team.e.g.{"export":true} - forms string[]
Only these forms (keys). [] = every form.
-
Sees only what is assigned to them.
-
With own_only: also sees unassigned submissions, to pick them up.
-
Numbers, e-mail addresses and answers of type phone or email are masked for this member.
- notify object
Responses
Fields
- success boolean
- request_id string
- member object
A person who works in the shared inbox. The assignee of a submission is a member id.
17 fields
- name stringe.g.
Sam - role string
owner: The account owner. Every ability. Cannot be changed or removed.admin: Every ability.manager: note, reply, edit, stage, assign, files, export, delete, run.agent: note, reply, edit, stage, files, run.viewer: Sees submissions, changes nothing.owneradminmanageragentviewer -
What the member may do now: the role's set with their own changes.
note: Write internal notes.reply: Reply to the submitter.edit: Edit answers and internal fields.stage: Change the stage.assign: Assign to anyone (an agent may always take a submission themselves).files: Add and remove files.export: Export.delete: Delete and restore.run: Run manual automations.forms: Manage forms and lists.automations: Manage automations and connections.team: Manage the team. - forms string[]
Only these forms (keys). [] = every form.
-
Sees only what is assigned to them.
-
With own_only: also sees unassigned submissions, to pick them up.
-
Numbers, e-mail addresses and answers of type phone or email are masked for this member.
- notify object
- id integere.g.
12 - email stringe.g.
sam@example.com -
Only the member's own changes to the role's set.
- status string
invitedactiveremoved - invite_expired boolean
true: the invitation was not accepted in time; invite the address again.
- invited string (date-time)
- accepted string (date-time) | null
- last_seen string (date-time) | null
- open_count integer
Open submissions assigned to them.
- invite_link string
After an invitation: the link in the e-mail. It works for 14 days.
- email_sent boolean
After an invitation. false: the e-mail could not be sent, pass invite_link on yourself.
- note string
Errors
- 400 The request is malformed (missing or invalid fields, query parameters or times).
- 401 Missing, invalid, revoked or expired API key.
- 403 The key is valid but this call is not allowed: the key lacks the scope the call needs (insufficient_scope), the address is not allowed for the key (ip_not_allowed), the number or plan does not allow it, a recipient opted out or is not opted in, or a problem with the WhatsApp account.
- 404 The number, template, message, broadcast, webhook, delivery, opt-in, logged request, booking or Flow was not found.
- 415 The body is not JSON.
- 429 A monthly plan limit, the number's own monthly cap, the key's daily cap, a WhatsApp rate limit, the API rate limit (rate_limited), or the webhook test limit (too_many_tests) was reached. Retry-After and error.retry_after_seconds say how long to wait.
- 500 Unexpected error on app2email's side.
- 503 app2email's connection to the WhatsApp account needs attention, or the request log is not available right now.