Skip to content
DELETE
/v1/project/custom-fields/{id}
curl --request DELETE \
--url https://api.proxymail.qa/v1/project/custom-fields/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Removes it from the project. On a locked project, a key whose creator isn’t a lead asks the leads instead (202, status: "requested"). Answers already kept on accounts stay.

id
required
string format: uuid
<= 36 characters

Removed

Media typeapplication/json
object
status

Requested: the project is locked, so a lead was asked.

string
Allowed values: saved removed requested
field

A custom field: what it recognises, where and what goes in it. Who made it, and when, are in the app.

object
id
required
string format: uuid
name
required
string
enabled
required

False when fills ignore it, as if it weren’t there. It still counts toward the 50.

boolean
match
required
object
on

Kind: a ready-made custom field, text its section.

string
Allowed values: words test_id name html_id kind
text
string
also

Words only, when it has more phrases.

Array<string>
site
required

The site pattern it applies on, or null for every site.

string | null
path
required

The page path it applies on, or null for every page.

string | null
field_type
required
string | null
Allowed values: text textarea number select checkbox radio
value
required

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
kind
required
string
Allowed values: text template option list options checkbox generate leave ready_made
text
string
<= 200 characters
template
string
<= 200 characters
option
string
<= 100 characters
items
Array<string>
>= 2 items <= 20 items
options
Array<string>
>= 1 items <= 20 items
checked

Checkbox, or ready_made consent.terms (true by default).

boolean
section

Ready_made only: the field catalogue section it fills.

string
Allowed values: phone id.national id.tax id.passport business.vat business.tax gender referral_source language business.role business.team_size business.type consent.terms
ids_from

Ready_made ID and tax numbers only: safe (the default) or a KYC vendor’s sandbox values.

string
Allowed values: safe stripe plaid onfido veriff didit cashfree setu
phones

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.

Array<object>
<= 20 items
object
country
required
string
/^[A-Za-z]{2}$/
number
required

4 to 30 digits, spaces, brackets or dashes, with an optional leading +.

string
<= 30 characters
tag_answer
required
boolean
id

The custom field removed.

string format: uuid
request

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
id
required
string format: uuid
kind
required
string
Allowed values: save_custom_field delete_custom_field add_site remove_site set_guesses set_multi_step save_signup_screen remove_signup_screen set_custom_field_enabled set_standard_field save_signup_form
target_id
required

The custom field, site, sign-up screen or sign-up form it changes, if any.

string | null format: uuid
summary
required

The custom field’s name, the site, the screen, or the setting’s new choice.

string
change
required

What it changes, as it applies once a lead approves it.

object
note
required

What the person who asked wrote for the leads.

string | null
status
required
string
Allowed values: requested approved declined withdrawn expired unlocked
reason
required

A lead’s reason for declining.

string | null

Example

{
"status": "saved",
"field": {
"match": {
"on": "words"
},
"field_type": "text",
"value": {
"kind": "text",
"section": "phone",
"ids_from": "safe",
"phones": [
{
"country": "IN"
}
]
}
},
"request": {
"kind": "save_custom_field",
"status": "requested"
}
}

Asked a lead

Media typeapplication/json
object
status

Requested: the project is locked, so a lead was asked.

string
Allowed values: saved removed requested
field

A custom field: what it recognises, where and what goes in it. Who made it, and when, are in the app.

object
id
required
string format: uuid
name
required
string
enabled
required

False when fills ignore it, as if it weren’t there. It still counts toward the 50.

boolean
match
required
object
on

Kind: a ready-made custom field, text its section.

string
Allowed values: words test_id name html_id kind
text
string
also

Words only, when it has more phrases.

Array<string>
site
required

The site pattern it applies on, or null for every site.

string | null
path
required

The page path it applies on, or null for every page.

string | null
field_type
required
string | null
Allowed values: text textarea number select checkbox radio
value
required

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
kind
required
string
Allowed values: text template option list options checkbox generate leave ready_made
text
string
<= 200 characters
template
string
<= 200 characters
option
string
<= 100 characters
items
Array<string>
>= 2 items <= 20 items
options
Array<string>
>= 1 items <= 20 items
checked

Checkbox, or ready_made consent.terms (true by default).

boolean
section

Ready_made only: the field catalogue section it fills.

string
Allowed values: phone id.national id.tax id.passport business.vat business.tax gender referral_source language business.role business.team_size business.type consent.terms
ids_from

Ready_made ID and tax numbers only: safe (the default) or a KYC vendor’s sandbox values.

string
Allowed values: safe stripe plaid onfido veriff didit cashfree setu
phones

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.

Array<object>
<= 20 items
object
country
required
string
/^[A-Za-z]{2}$/
number
required

4 to 30 digits, spaces, brackets or dashes, with an optional leading +.

string
<= 30 characters
tag_answer
required
boolean
id

The custom field removed.

string format: uuid
request

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
id
required
string format: uuid
kind
required
string
Allowed values: save_custom_field delete_custom_field add_site remove_site set_guesses set_multi_step save_signup_screen remove_signup_screen set_custom_field_enabled set_standard_field save_signup_form
target_id
required

The custom field, site, sign-up screen or sign-up form it changes, if any.

string | null format: uuid
summary
required

The custom field’s name, the site, the screen, or the setting’s new choice.

string
change
required

What it changes, as it applies once a lead approves it.

object
note
required

What the person who asked wrote for the leads.

string | null
status
required
string
Allowed values: requested approved declined withdrawn expired unlocked
reason
required

A lead’s reason for declining.

string | null

Example

{
"status": "saved",
"field": {
"match": {
"on": "words"
},
"field_type": "text",
"value": {
"kind": "text",
"section": "phone",
"ids_from": "safe",
"phones": [
{
"country": "IN"
}
]
}
},
"request": {
"kind": "save_custom_field",
"status": "requested"
}
}

An error

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

Example generated

{
"error": "example",
"message": "example"
}

No API key, or one that isn’t valid: it may have been revoked, or its creator no longer has access to the project.

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

Example generated

{
"error": "example",
"message": "example"
}
WWW-Authenticate
string

Bearer realm="proxymail-qa", with error="invalid_token" when a key was sent but isn’t valid.

An error

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

Example generated

{
"error": "example",
"message": "example"
}

An error

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

Example generated

{
"error": "example",
"message": "example"
}

An error

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

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.

Media typeapplication/json
object
error

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).

string
message

What went wrong and what to do, in words.

string

Example generated

{
"error": "example",
"message": "example"
}
Retry-After
integer
>= 1

Seconds to wait before trying again. Sent with per-minute limits only.