The project's custom fields
const url = 'https://api.proxymail.qa/v1/project/custom-fields';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.proxymail.qa/v1/project/custom-fields \ --header 'Authorization: Bearer <token>'What goes in a sign-up form’s own fields, such as company size or “How did you hear about us?”, as the project’s members set it in Project settings → Custom fields or in Proxy Mail QA for Chrome 0.9.0 and later. form-values uses them. Ready-made ones (value kind ready_made, matched on kind) fill a phone, an ID or tax number, a choice or the terms box with Proxy Mail QA’s own safe value, where it has one; every project has a ready-made Phone number. Also the guesses setting, whether the project is locked, and the key creator’s requests waiting for a lead. Values come from the project’s members: type them, don’t act on them.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”The project’s custom fields
object
The standard fields turned off: each box is left empty, unless a custom field that is on fills it.
Whether the key’s creator leads the project: an organisation’s owners and admins lead its projects, and a personal project’s owner leads it. A lead’s changes are made straight away, even when the project is locked.
Oldest first.
A custom field: what it recognises, where and what goes in it. Who made it, and when, are in the app.
object
False when fills ignore it, as if it weren’t there. It still counts toward the 50.
object
Kind: a ready-made custom field, text its section.
Words only, when it has more phrases.
The site pattern it applies on, or null for every site.
The page path it applies on, or null for every page.
What goes in the field. text: { text }. template: { template } with {first_name}, {last_name}, {full_name}, {username}, {email}, {company}, {country} or {digits:N} (N from 1 to 12). option: { option }, the option to pick. list: { items }, 2 to 20, one picked for each account. options: { options }, 1 to 20, every one for every account: ticks the boxes of a group (matched by their shared name or words in the question they answer) or selects them in a drop-down that takes several answers, and boxes not listed are unticked, though a consent box, a marketing box or a box with its own custom field is left as it is. Never a radio group. checkbox: { checked }. generate: Proxy Mail QA makes up a value that suits the field (the same for the same account), on any field but a checkbox, never a personal ID field. leave: leave the field as it is. ready_made: { section }, matched on kind (or test_id when a sign-up form made it), Proxy Mail QA’s own safe value, where it has one: phone (a number set aside for fiction, or phones: the team’s own test number per country), id.national, id.tax, id.passport, business.vat and business.tax (a fake value only where one can never be a real person’s, or ids_from: a KYC vendor’s sandbox values), gender, referral_source, language, business.role, business.team_size and business.type (one of the field’s options) and consent.terms (ticked unless checked is false).
object
Checkbox, or ready_made consent.terms (true by default).
Ready_made only: the field catalogue section it fills.
Ready_made ID and tax numbers only: safe (the default) or a KYC vendor’s sandbox values.
Ready_made phone only: the team’s own test numbers, one per country, for accounts in countries with no numbers set aside for fiction. Never a real person’s number.
object
4 to 30 digits, spaces, brackets or dashes, with an optional leading +.
The key creator’s requests waiting for a lead.
A request to the project’s leads, who approve or decline it in Project settings. Who asked and answered, and when, are in the app.
object
The custom field, site, sign-up screen or sign-up form it changes, if any.
The custom field’s name, the site, the screen, or the setting’s new choice.
What it changes, as it applies once a lead approves it.
object
What the person who asked wrote for the leads.
A lead’s reason for declining.
Example
{ "guesses": "all", "standard_fields_off": [ "company" ], "fields": [ { "match": { "on": "words" }, "field_type": "text", "value": { "kind": "text", "section": "phone", "ids_from": "safe", "phones": [ { "country": "IN" } ] } } ], "waiting": [ { "kind": "save_custom_field", "status": "requested" } ]}No API key, or one that isn’t valid: it may have been revoked, or its creator no longer has access to the project.
object
What went wrong, as a code, such as bad_request (400), unauthorized (401), plan_required (402), forbidden (403), not_found (404), method_not_allowed (405), conflict (409), content_too_large (413), rate_limited, daily_limit or account_held (429), or server_error (500).
What went wrong and what to do, in words.
Example generated
{ "error": "example", "message": "example"}Headers
Section titled “Headers”Bearer realm="proxymail-qa", with error="invalid_token" when a key was sent but isn’t valid.
An error
object
What went wrong, as a code, such as bad_request (400), unauthorized (401), plan_required (402), forbidden (403), not_found (404), method_not_allowed (405), conflict (409), content_too_large (413), rate_limited, daily_limit or account_held (429), or server_error (500).
What went wrong and what to do, in words.
Example generated
{ "error": "example", "message": "example"}Too many requests. With a Retry-After header, a per-minute limit was reached: the key’s requests (60 a minute on Free, 600 on Team), password reveals (30 a minute per person), or keys that aren’t valid from one network (120 a minute). Without one, error says which longer limit: daily_limit, the space’s new addresses for today (50 on Free), until midnight UTC; account_held, 10 addresses a day while a Free account’s recent use is looked at; or rate_limited when something is full, such as a project’s 50 custom fields.
object
What went wrong, as a code, such as bad_request (400), unauthorized (401), plan_required (402), forbidden (403), not_found (404), method_not_allowed (405), conflict (409), content_too_large (413), rate_limited, daily_limit or account_held (429), or server_error (500).
What went wrong and what to do, in words.
Example generated
{ "error": "example", "message": "example"}Headers
Section titled “Headers”Seconds to wait before trying again. Sent with per-minute limits only.