{"templateId":"../../@theme/Templates/ChangelogEntry","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Choose which parties require SMS authentication","siteUrl":"https://developers.signable.app","description":"Integrate Signable’s eSignature API to send, sign, and manage documents with envelopes and webhooks.","image":"/assets/hero-placeholder-small.5b052639e5d5a3b6265375db1ac2835173dda2c0ed22f8c167f6284080cc84ce.db81178d.png","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-which-parties-require-sms-authentication","__idx":0},"children":["Choose which parties require SMS authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now set SMS one-time password (OTP) authentication for individual parties. Previously, this was an envelope-level setting: either all signers required an OTP, or none did."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This gives you more flexibility to require additional verification for selected signers within the same envelope."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-changes-in-the-api","__idx":1},"children":["What changes in the API?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating an envelope:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["party_mobile"]}," for a party to require SMS OTP authentication when they sign."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Omit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["party_mobile"]}," for a party if they do not require SMS OTP authentication."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelope_requires_otp"]}," field is still accepted but is ignored. You do not need to remove it from existing requests, but each party’s ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["party_mobile"]}," now determines whether they require OTP authentication."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In responses, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelope_requires_otp"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," if at least one signer on the envelope requires OTP authentication, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," otherwise."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.signable.app/openapi/envelopes"},"children":["Envelopes API reference"]}," for more information."]}]},"headings":[{"value":"Choose which parties require SMS authentication","id":"choose-which-parties-require-sms-authentication","depth":2},{"value":"What changes in the API?","id":"what-changes-in-the-api","depth":3}],"frontmatter":{"title":"Per-party SMS authentication","date":"2026-08-13T00:00:00.000Z","type":"API","breaking":false,"template":"../../@theme/Templates/ChangelogEntry","seo":{"title":"Choose which parties require SMS authentication"}},"lastModified":"2026-09-29T11:51:01.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/changelog/entries/2026-08-13-per-party-otp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}