Create Verification
create_single_verificationUsage Instructions
Purchase one verification using the requested service and capabilities in request. This can spend account credits; check the user's intended service and obtain purchase approval first. The result is a verification detail-tool reference; invoke it to inspect the reservation and follow its sale reference for transaction details. Use a stable idempotencyKey when retrying the same purchase after an uncertain response. Requires resources.purchase. Both idempotencyKey and request.maxPrice are optional. A price limit is enforced at purchase time. Retry an uncertain outcome only with the same key and identical request, or inspect sales first.
Read-writeThis tool may create, modify, or delete account resources.Not open-worldThis tool operates only within Textverified.DestructiveThis tool may permanently delete or irreversibly change data. Confirm before running it.Not idempotentRepeating this tool may repeat its side effects. Check the result before retrying.
Required scopes
resources.readresources.purchaseAdditional information
Use idempotencyKey for reliable retries and request.maxPrice to cap the execution-time charge.
Warnings
A timeout may occur after a purchase commits. Without the original key, inspect sales before retrying.
Input Schema
requestobject | nullrequiredareaCodeSelectOptionarray | nullitemsstring | nullcarrierSelectOptionarray | nullitemsstring | nullserviceNamestring | nullrequiredcapabilitystringrequiredserviceNotListedNamestring | nullmaxPricenumber | nullidempotencyKeystring | null{
"type": "object",
"properties": {
"request": {
"type": [
"object",
"null"
],
"properties": {
"areaCodeSelectOption": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"carrierSelectOption": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"serviceName": {
"type": [
"string",
"null"
]
},
"capability": {
"type": "string",
"enum": [
"Sms",
"Voice",
"SmsAndVoiceCombo"
]
},
"serviceNotListedName": {
"type": [
"string",
"null"
]
},
"maxPrice": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 1.7976931348623157e+308
}
},
"required": [
"serviceName",
"capability"
]
},
"idempotencyKey": {
"description": "Optional purchase retry key. Reuse the same key and identical purchase parameters after an uncertain response; omitting it leaves retries unprotected.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"request"
]
}Output Schema
toolstringrequiredargumentsobjectrequired{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"arguments": {
"type": "object"
}
},
"required": [
"tool",
"arguments"
]
}