v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-04-145745483.2 KB
VerifyV2NewFactor

Create a new Passkeys Factor for the Entity

Create a new Passkeys Factor for the Entity

post/v2/Services/{ServiceSid}/Passkeys/Factors

Path parameters

ServiceSidstring required

The unique SID identifier of the Service.

Request body

friendly_namestring required
identitystring required

Response

Created

sidstring nullable

A 34 character string that uniquely identifies this Factor.

account_sidstring nullable

The unique SID identifier of the Account.

service_sidstring nullable

The unique SID identifier of the Service.

entity_sidstring nullable

The unique SID identifier of the Entity.

identitystring nullable

Customer unique identity for the Entity owner of the Factor.

{"stackTrail":"paths:/v2/Services/{ServiceSid}/Passkeys/Factors:post:responses:201:content:application/json:schema:properties:binding","oasType":"schema","type":"unknown","description":"Contains the `factor_type` specific secret and metadata. The Binding property is ONLY returned upon Factor creation.","extensionFields":{"x-twilio":{"shortDescription":"Binding of the factor"}},"nullable":true}
{"stackTrail":"paths:/v2/Services/{ServiceSid}/Passkeys/Factors:post:responses:201:content:application/json:schema:properties:options","oasType":"schema","type":"unknown","nullable":true}
date_createdstring date-time nullable

The date that this Factor was created, given in ISO 8601 format.

date_updatedstring date-time nullable

The date that this Factor was updated, given in ISO 8601 format.

friendly_namestring nullable

The friendly name of this Factor. This can be any string up to 64 characters, meant for humans to distinguish between Factors.

status'unverified' | 'verified'

The Status of this Factor. One of unverified or verified.

factor_type'push' | 'totp' | 'passkeys'

The Type of this Factor. Currently push and totp are supported.

{"stackTrail":"paths:/v2/Services/{ServiceSid}/Passkeys/Factors:post:responses:201:content:application/json:schema:properties:config","oasType":"schema","type":"unknown","description":"An object that contains configurations specific to a `factor_type`.","extensionFields":{"x-twilio":{"shortDescription":"Configurations for a `factor_type`."}},"nullable":true}
{"stackTrail":"paths:/v2/Services/{ServiceSid}/Passkeys/Factors:post:responses:201:content:application/json:schema:properties:metadata","oasType":"schema","type":"unknown","description":"Custom metadata associated with the factor.","extensionFields":{"x-twilio":{"shortDescription":"Metadata of the factor.","pii":{"handling":"standard","deleteSla":30}}},"nullable":true}
urlstring uri nullable

The URL of this resource.