{"items":[{"type":"link","label":"Fax API","link":"/docs/fax/api-reference/fax","routeSlug":"/docs/fax/api-reference/fax","content":{"contentType":"overview","meta":{"name":"Fax API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"fax.json","url":"/_bundle/docs/fax/api-reference/fax.json?download"},{"kind":"download","label":"fax.yaml","url":"/_bundle/docs/fax/api-reference/fax.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://www.sinch.com/contact/","url":"https://www.sinch.com/contact/"},{"kind":"email","title":"Contact Fax API Team","email":"faxteam@sinch.com","label":"faxteam@sinch.com","withCopyButton":true,"copyContent":"faxteam@sinch.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"MIT","url":"https://www.sinch.com/toc"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Fax API (3.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This document provides a detailed user guide and reference documentation on the Fax REST API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you have questions please contact us via our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://support.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"support portal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a team member will be happy to assist."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You must create an account on our support portal if you do not have one."},"children":[]}]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax"}],"sectionId":"/docs/fax/api-reference/fax"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For information on how to authenticate API requests we support two methods "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/authentication/basic"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Basic"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/authentication/oauth"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Oauth2"},"children":[]}]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/authentication"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/global-url"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Global URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sinch has a global server that will route your call to the appropriate geography region automatically:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"https://fax.api.sinch.com/\n","language":"shell"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"https://fax.api.sinch.com/\n"},"children":[]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/global-url"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/formats"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Formats"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default, all API calls return a JSON response unless otherwise specified."},"children":[]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/formats"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/date-time-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date time fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All date and time fields are in UTC format unless otherwise specified."},"children":[]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/date-time-fields"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/deletion-and-data-retention"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletion and data retention"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you have enabled storage, we retain fax logs and media for 13 months which you can access via the API. After 13 months, media and logs are deleted."},"children":[]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/deletion-and-data-retention"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/errors-and-statuses"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Errors & statuses"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Find error codes and explanations "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/errors-and-statuses"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"section/webhooks"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can configure your service to use webhooks to send a request to you when faxes arrive or complete on your account."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" When webhooks with Basic authentication credentials are shown in GET requests, the credentials are masked with `***`` symbols. It is not possible to retrieve previously-set credentials through the API."},"children":[]}]}]}]}],"sectionId":"/docs/fax/api-reference/fax/section/webhooks"}]}]}},{"type":"link","label":"Authentication","link":"/docs/fax/api-reference/fax/section/authentication","routeSlug":"/docs/fax/api-reference/fax/section/authentication","content":null},{"type":"link","label":"Global URL","link":"/docs/fax/api-reference/fax/section/global-url","routeSlug":"/docs/fax/api-reference/fax/section/global-url","content":null},{"type":"link","label":"Formats","link":"/docs/fax/api-reference/fax/section/formats","routeSlug":"/docs/fax/api-reference/fax/section/formats","content":null},{"type":"link","label":"Date time fields","link":"/docs/fax/api-reference/fax/section/date-time-fields","routeSlug":"/docs/fax/api-reference/fax/section/date-time-fields","content":null},{"type":"link","label":"Deletion and data retention","link":"/docs/fax/api-reference/fax/section/deletion-and-data-retention","routeSlug":"/docs/fax/api-reference/fax/section/deletion-and-data-retention","content":null},{"type":"link","label":"Errors & statuses","link":"/docs/fax/api-reference/fax/section/errors-and-statuses","routeSlug":"/docs/fax/api-reference/fax/section/errors-and-statuses","content":null},{"type":"link","label":"Webhooks","link":"/docs/fax/api-reference/fax/section/webhooks","routeSlug":"/docs/fax/api-reference/fax/section/webhooks","content":null},{"type":"group","label":"Faxes","link":"/docs/fax/api-reference/fax/faxes","routeSlug":"/docs/fax/api-reference/fax/faxes","items":[{"label":"Send a fax","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/sendfax","routeSlug":"/docs/fax/api-reference/fax/faxes/sendfax","metadata":{"seo":{"title":"Send a fax","description":"Create and send a fax."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sendFax","name":"Send a fax","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send a fax","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create and send a fax."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax content may be supplied via one or more files or URLs of supported filetypes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint supports the following content types for the fax payload:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart/form-data"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Application/json"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We will however always return a fax object in the response in application json. If you supply a callbackUrl the callback will be sent as multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with the content of the fax as an attachment to the body, "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unless"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you specify callbackUrlContentType as application/json."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"faxes/sendfax/request/file(s)","deepLinkHash":"/faxes/sendfax#faxes/sendfax/request/file(s)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"file(s)"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Files may be included in the POST request as multipart/form-data parts."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"faxes/sendfax/request/contenturl","deepLinkHash":"/faxes/sendfax#faxes/sendfax/request/contenturl"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contentUrl"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any URL on the Internet (including ones with basic authentication), and we'll pull it down and make it a fax. This might be useful to you if you're using a web framework for templates and creating fax files."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note: If you are passing fax a secure URL (starting with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), make sure that your SSL certificate (including your intermediate cert, if you have one) is installed properly, valid, and up-to-date."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_639","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"]},"application/json":{"schemaId":"schema_640","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendWebPageAsFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxJson"]}},"schemaId":"schema_639","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v3/projects/{projectId}/faxes","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_639","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"]},"application/json":{"schemaId":"schema_640","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendWebPageAsFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxJson"]}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/faxes","href":"faxes/sendfax","openApiOperationId":"sendFax","summary":"Send a fax","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The recipient number you want to send a Fax to\n const faxRecipientNumber = 'FAX_RECIPIENT_NUMBER';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxes.send({\n sendFaxRequestBody: {\n to: faxRecipientNumber,\n contentUrl: 'https://developers.sinch.com/fax/fax.pdf',\n },\n });\n console.log('✅ Successfully sent the Fax.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to send the Fax to the recipient number ${faxRecipientNumber}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_639","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"],"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_639","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"]},"application/json":{"schemaId":"schema_640","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxWithCoverPage","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendWebPageAsFax","paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxJson"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The created fax","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/sendfax"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes"},{"label":"List faxes","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/getfaxes","routeSlug":"/docs/fax/api-reference/fax/faxes/getfaxes","metadata":{"seo":{"title":"List faxes","description":"List faxes sent (OUTBOUND) or received (INBOUND), set parameters to filter the list.Example: Return calls made between 1st of January 2021 and 10th of January 2021."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getFaxes","name":"List faxes","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List faxes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List faxes sent (OUTBOUND) or received (INBOUND), set parameters to filter the list."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example: Return calls made between 1st of January 2021 and 10th of January 2021."},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":" created>=2021-01-01&startTime<=2021-01-10\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":" created>=2021-01-01&startTime<=2021-01-10\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"serviceId","in":"query","schemaId":"schema_641","description":"Limits results to faxes that were sent using the specified service."},{"name":"createTime","in":"query","schemaId":"schema_642","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter calls based on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createTime"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If you make the query more precise, fewer results will be returned."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2021-02-01"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will return all calls from the first of February 2021, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2021-02-01T14:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will return all calls after 14:00 on the first of February."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field also supports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":">="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to search for calls in a range "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?createTime>=2021-10-01&startTime<=2021-10-30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to get a list of calls for all of October 2021."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is also possible to submit partial dates. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createTime=2021-02"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will return all calls for February 2021."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If not value is submitted, the default value is the prior week."},"children":[]}]}]}]},{"name":"direction","in":"query","schemaId":"schema_643","description":"Limits results to faxes with the specified direction.","example":"OUTBOUND"},{"name":"status","in":"query","schemaId":"schema_644","description":"Limits results to faxes with the specified status.","example":"COMPLETED"},{"name":"to","in":"query","schemaId":"schema_645","description":"Filters the results by the phone number to which the fax was sent. The parameter search with startsWith, so you can pass a partial number to get all faxes sent to numbers that start with the number you passed.","example":"+14155552222"},{"name":"from","in":"query","schemaId":"schema_645","description":"Filters the results by the phone number from which the fax was sent. The parameter search with startsWith, so you can pass a partial number to get all faxes sent to numbers that start with the number you passed."},{"name":"labels","in":"query","schemaId":"schema_646"},{"name":"format","in":"query","schemaId":"schema_647","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you include this parameter, you can export the list of faxes as a .csv file. Default value is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"csv"},"children":[]}]}]}]},{"name":"pageSize","in":"query","schemaId":"schema_648","description":"The maximum number of items to return per request. The default is 100 and the maximum is 1000. If you need to export larger amounts and pagination is not suitable for you can use the Export function in the dashboard."},{"name":"page","in":"query","schemaId":"schema_649","description":"The page you want to retrieve returned from a previous List request, if any"},{"name":"fromCountry","in":"query","schemaId":"schema_650","description":"Filter by the country which sent the fax. The country code should be in ISO 3166-1 alpha-2 format."},{"name":"toCountry","in":"query","schemaId":"schema_650","description":"Filter by the country to which the fax was sent. The country code should be in ISO 3166-1 alpha-2 format."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/faxes","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[{"name":"serviceId","in":"query","example":"YOUR_SERVICE_ID","schemaId":"schema_641"},{"name":"createTime","in":"query","schemaId":"schema_642"},{"name":"direction","in":"query","example":"OUTBOUND","schemaId":"components/schemas/FaxDirection"},{"name":"status","in":"query","example":"COMPLETED","schemaId":"components/schemas/FaxStatus"},{"name":"to","in":"query","example":"+14155552222","schemaId":"components/schemas/PhoneNumber"},{"name":"from","in":"query","example":"+15551235656","schemaId":"components/schemas/PhoneNumber"},{"name":"labels","in":"query","example":{"use-case":"fraudPrevention","costCenter":"sales"},"schemaId":"components/schemas/Labels"},{"name":"format","in":"query","example":"csv","schemaId":"schema_647"},{"name":"pageSize","in":"query","schemaId":"schema_648"},{"name":"page","in":"query","schemaId":"schema_649"},{"name":"fromCountry","in":"query","example":"US","schemaId":"schema_650"},{"name":"toCountry","in":"query","example":"US","schemaId":"schema_650"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/faxes","href":"faxes/getfaxes","openApiOperationId":"getFaxes","summary":"List faxes","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxes.list({});\n if (response.data.length === 0) {\n console.log('No Faxes found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Faxes.`);\n response.data.forEach((fax) => {\n console.log(fax);\n });\n } catch (err) {\n console.error('❌ Failed to list Faxes:');\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Result of the query.","mediaType":"application/json","mediaTypes":["application/json","text/csv"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListFaxesObject"},"text/csv":{"schemaId":"schema_651"}},"schemaId":"components/schemas/ListFaxesObject"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ListFaxesObject","mediaTypes":["application/json","text/csv"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ListFaxesObject"},"text/csv":{"schemaId":"schema_651"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/getfaxes"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes"},{"label":"Get fax","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/getfaxinfoperid","routeSlug":"/docs/fax/api-reference/fax/faxes/getfaxinfoperid","metadata":{"seo":{"title":"Get fax","description":"Get fax information using the ID number of the fax."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getFaxInfoPerId","name":"Get fax","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get fax","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get fax information using the ID number of the fax."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_652","description":"The ID of the fax.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/faxes/{id}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"01F3J0G1M4WQR6HGY6HCF6JA0K","schemaId":"components/schemas/FaxId"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/faxes/{id}","href":"faxes/getfaxinfoperid","openApiOperationId":"getFaxInfoPerId","summary":"Get fax","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax ID you want to retrieve\n const faxId = 'FAX_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxes.get({ id: faxId });\n console.log('✅ Successfully retrieved the Fax.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to retrieve the Fax with ID: ${faxId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The fax","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Fax","exampleIds":["paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/getfaxinfoperid"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes/{id}"},{"label":"Download fax content","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/getfaxfilebyid","routeSlug":"/docs/fax/api-reference/fax/faxes/getfaxfilebyid","metadata":{"seo":{"title":"Download fax content","description":"Download the fax content."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getFaxFilebyId","name":"Download fax content","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download fax content","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Download the fax content."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_652","description":"The ID of the fax.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/faxes/{id}/file","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"01F3J0G1M4WQR6HGY6HCF6JA0K","schemaId":"components/schemas/FaxId"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/faxes/{id}/file","href":"faxes/getfaxfilebyid","openApiOperationId":"getFaxFilebyId","summary":"Download fax content","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport { writeFileSync } from 'fs';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax ID you want to download the content from\n const faxId = 'FAX_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxes.downloadContent({\n id: faxId,\n });\n console.log('✅ Successfully downloaded the Fax content.');\n writeFileSync(`fax_${faxId}.pdf`, response.buffer);\n } catch (err) {\n console.error(`❌ Failed to download the content from the Fax with ID: ${faxId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A file for the fax you requested will be returned in the format you specified.","mediaType":"application/pdf","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_653"}},"schemaId":"schema_653"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_653","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_653"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/getfaxfilebyid"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes/{id}/file"},{"label":"Delete fax content","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/deletefaxcontentbyid","routeSlug":"/docs/fax/api-reference/fax/faxes/deletefaxcontentbyid","metadata":{"seo":{"title":"Delete fax content","description":"Delete the fax content for a fax using the ID number of the fax. Please note that this only deletes the content of the fax from storage."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteFaxContentById","name":"Delete fax content","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete fax content","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Delete the fax content for a fax using the ID number of the fax.\nPlease note that this only deletes the content of the fax from storage."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_652","description":"The ID of the fax.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v3/projects/{projectId}/faxes/{id}/file","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"01F3J0G1M4WQR6HGY6HCF6JA0K","schemaId":"components/schemas/FaxId"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["204"],"pointer":"/v3/projects/{projectId}/faxes/{id}/file","href":"faxes/deletefaxcontentbyid","openApiOperationId":"deleteFaxContentById","summary":"Delete fax content","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax ID you want to delete the content from\n const faxId = 'FAX_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n await sinch.fax.faxes.deleteContent({ id: faxId });\n console.log(`✅ Successfully deleted content from the Fax with ID ${faxId}.`);\n } catch (err) {\n console.error(`❌ Failed to delete content from the Fax with ID: ${faxId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The fax content was deleted."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/deletefaxcontentbyid"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes/{id}/file"},{"label":"Download fax content","deprecated":true,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/faxes/getfaxfilebyiddeprecated","routeSlug":"/docs/fax/api-reference/fax/faxes/getfaxfilebyiddeprecated","metadata":{"seo":{"title":"Download fax content","description":"Download the fax content."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getFaxFileByIdDeprecated","name":"Download fax content","deprecated":true,"isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file.{fileFormat}/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download fax content","isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Download the fax content."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_652","description":"The ID of the fax.","required":true},{"name":"fileFormat","in":"path","schemaId":"schema_654","description":"The file format to download. Currently only PDF is supported.","required":true,"example":"pdf"},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file.{fileFormat}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/faxes/{id}/file.{fileFormat}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"01F3J0G1M4WQR6HGY6HCF6JA0K","schemaId":"components/schemas/FaxId"},{"name":"fileFormat","in":"path","required":true,"example":"pdf","schemaId":"schema_654"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/faxes/{id}/file.{fileFormat}","href":"faxes/getfaxfilebyiddeprecated","openApiOperationId":"getFaxFileByIdDeprecated","summary":"Download fax content","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport { writeFileSync } from 'fs';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax ID you want to download the content from\n const faxId = 'FAX_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxes.downloadContent({\n id: faxId,\n fileFormat: 'pdf',\n });\n console.log('✅ Successfully downloaded the Fax content (deprecated /file.pdf path).');\n writeFileSync(`fax_${faxId}.pdf`, response.buffer);\n } catch (err) {\n console.error(`❌ Failed to download the content from the Fax with ID: ${faxId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A file for the fax you requested will be returned in the format you specified.","mediaType":"application/pdf","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_653"}},"schemaId":"schema_653"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1faxes~1{id}~1file.{fileFormat}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_653","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_653"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/getfaxfilebyiddeprecated"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/faxes/{id}/file.{fileFormat}"},{"type":"separator","label":"Webhooks","variant":"secondary","content":null},{"label":"Incoming fax event","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/docs/fax/api-reference/fax/faxes/incomingfaxevent","routeSlug":"/docs/fax/api-reference/fax/faxes/incomingfaxevent","metadata":{"seo":{"title":"Incoming fax event","description":"This webhook is triggered when a fax is received on a Sinch number associated with a service. The webhook will contain information about the fax, such as the sender, the recipient, and the content of the fax. You set the callback URL for incoming fax events on the service, either through the dashboard or using the service API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"incomingFaxEvent","name":"Incoming fax event","isWebhook":true,"pointer":"/paths/incomingFax/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Incoming fax event","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This webhook is triggered when a fax is received on a Sinch number associated with a service. The webhook will contain information about the fax, such as the sender, the recipient, and the content of the fax. You set the callback URL for incoming fax events on the service, either through the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/fax/services"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/services/createnotificationwebhook"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"service API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"notifications/incomingfaxevent/request/faxes/incomingfaxevent/request/example-payloads","deepLinkHash":"/notifications/incomingfaxevent#notifications/incomingfaxevent/request/faxes/incomingfaxevent/request/example-payloads"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example payloads"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart/form-data request payloads are encoded as forms with a content type of JSON and the actual fax content as a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'file' application/pdf attachment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Application/json request payloads are a JSON object with the file encoded as a base64 string as part of the JSON object."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"WebhookBasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can validate whether a webhook is genuine by providing credentials you set and will check on your server side along with the callback URL, as in this example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://username:password@www.YourWebhookWebsite.com"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","isEvent":true,"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"],"pointer":"/paths/incomingFax/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"incomingFax","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"WebhookBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"incomingFax","href":"faxes/incomingfaxevent","openApiOperationId":"incomingFaxEvent","summary":"Incoming fax event"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"],"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Returns a 200 OK response if the webhook was received successfully."}],"pointer":"/paths/incomingFax/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/incomingfaxevent"}],"panels":[]}]},"httpPath":"incomingFax"},{"label":"Fax completed","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/docs/fax/api-reference/fax/faxes/faxcompletedcallback","routeSlug":"/docs/fax/api-reference/fax/faxes/faxcompletedcallback","metadata":{"seo":{"title":"Fax completed","description":"Triggered when the fax has been completed. The callback will contain information about the fax, such as the sender, the recipient, and the content of the fax. You must set the callback URL where you want the callback sent when you make a send fax request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"faxCompletedCallback","name":"Fax completed","isWebhook":true,"pointer":"/paths/faxCompleted/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fax completed","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Triggered when the fax has been completed. The callback will contain information about the fax, such as the sender, the recipient, and the content of the fax. You must set the callback URL where you want the callback sent when you make a send fax request."},{"nodeType":"security","requirements":[{"schemes":[{"name":"WebhookBasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can validate whether a webhook is genuine by providing credentials you set and will check on your server side along with the callback URL, as in this example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://username:password@www.YourWebhookWebsite.com"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","isEvent":true,"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"],"pointer":"/paths/faxCompleted/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"faxCompleted","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"WebhookBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"faxCompleted","href":"faxes/faxcompletedcallback","openApiOperationId":"faxCompletedCallback","summary":"Fax completed"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"],"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Returns a 200 OK response if the webhook was received successfully."}],"pointer":"/paths/faxCompleted/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/faxes/faxcompletedcallback"}],"panels":[]}]},"httpPath":"faxCompleted"}],"content":{"contentType":"group","meta":{"name":"Faxes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Faxes","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Fax API allows you to send and receive faxes. You can send faxes to a single recipient or to multiple recipients. You can also receive faxes and download them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To send a TEST Outbound fax you can send a fax TO +19898989898. This will emulate all aspects of a real fax without charging your account."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/faxes","summary":"Send a fax","prefix":{"name":"post","color":"post"},"badges":[],"link":"/faxes/sendfax","deprecated":false},{"title":"/v3/projects/{projectId}/faxes","summary":"List faxes","prefix":{"name":"get","color":"get"},"badges":[],"link":"/faxes/getfaxes","deprecated":false},{"title":"/v3/projects/{projectId}/faxes/{id}","summary":"Get fax","prefix":{"name":"get","color":"get"},"badges":[],"link":"/faxes/getfaxinfoperid","deprecated":false},{"title":"/v3/projects/{projectId}/faxes/{id}/file","summary":"Download fax content","prefix":{"name":"get","color":"get"},"badges":[],"link":"/faxes/getfaxfilebyid","deprecated":false},{"title":"/v3/projects/{projectId}/faxes/{id}/file","summary":"Delete fax content","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/faxes/deletefaxcontentbyid","deprecated":false},{"title":"/v3/projects/{projectId}/faxes/{id}/file.{fileFormat}","summary":"Download fax content","prefix":{"name":"get","color":"http-deprecated"},"badges":[],"link":"/faxes/getfaxfilebyiddeprecated","deprecated":true}]},{"kind":"group-items","title":"Webhooks","titleTranslationKey":"webhooks","items":[{"title":"incomingFax","summary":"Incoming fax event","prefix":{"name":"post","color":"post"},"badges":[],"link":"/faxes/incomingfaxevent","deprecated":false},{"title":"faxCompleted","summary":"Fax completed","prefix":{"name":"post","color":"post"},"badges":[],"link":"/faxes/faxcompletedcallback","deprecated":false}]}]}]}]}},{"type":"group","label":"Notifications","link":"/docs/fax/api-reference/fax/notifications","routeSlug":"/docs/fax/api-reference/fax/notifications","items":[{"type":"link","label":"Setting up webhooks","link":"/docs/fax/api-reference/fax/notifications/setting-up-webhooks","routeSlug":"/docs/fax/api-reference/fax/notifications/setting-up-webhooks","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Setting up webhooks"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"notifications/setting-up-webhooks"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting up webhooks"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Depending on the type of webhook, you can configure the callback URLs in a few ways:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Incoming fax notification"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/fax/services"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the dashboard."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/services/createnotificationwebhook"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API when configuring your service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is required to receive notifications about incoming calls to your Sinch number."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax completed notification"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By including the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"callbackUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property in the request body when you send a fax via the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/faxes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Retries","link":"/docs/fax/api-reference/fax/notifications/retries","routeSlug":"/docs/fax/api-reference/fax/notifications/retries","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Retries"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"notifications/retries"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retries"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a webhook fails, we will automatically retry sending the fax up to 16 times. There will be a delay before each retry, which increases as follows:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retry number"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delay"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cumulative wait"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5 minutes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"2"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"15 minutes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"3"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"35 minutes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"4"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"30 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 hour 5 minutes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5-16"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"6 hours"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"up to ~3 days"},"children":[]}]}]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"IP Addresses","link":"/docs/fax/api-reference/fax/notifications/ip-addresses","routeSlug":"/docs/fax/api-reference/fax/notifications/ip-addresses","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"IP Addresses"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"notifications/ip-addresses"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IP Addresses"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notifications are sent from the following IP addresses so you can add them to allowlists if necessary."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IP address"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"34.232.249.173"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"use1 (East)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"44.226.9.173"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"usw2 (West)"},"children":[]}]}]}]}]}]}]}],"panels":[]}]}},{"label":"Incoming fax event","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/docs/fax/api-reference/fax/notifications/incomingfaxevent","routeSlug":"/docs/fax/api-reference/fax/notifications/incomingfaxevent","metadata":{"seo":{"title":"Incoming fax event","description":"This webhook is triggered when a fax is received on a Sinch number associated with a service. The webhook will contain information about the fax, such as the sender, the recipient, and the content of the fax. You set the callback URL for incoming fax events on the service, either through the dashboard or using the service API."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"incomingFaxEvent","name":"Incoming fax event","isWebhook":true,"pointer":"/paths/incomingFax/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Incoming fax event","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This webhook is triggered when a fax is received on a Sinch number associated with a service. The webhook will contain information about the fax, such as the sender, the recipient, and the content of the fax. You set the callback URL for incoming fax events on the service, either through the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/fax/services"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/services/createnotificationwebhook"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"service API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"notifications/incomingfaxevent/request/faxes/incomingfaxevent/request/example-payloads","deepLinkHash":"/notifications/incomingfaxevent#notifications/incomingfaxevent/request/faxes/incomingfaxevent/request/example-payloads"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example payloads"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart/form-data request payloads are encoded as forms with a content type of JSON and the actual fax content as a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'file' application/pdf attachment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Application/json request payloads are a JSON object with the file encoded as a base64 string as part of the JSON object."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"WebhookBasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can validate whether a webhook is genuine by providing credentials you set and will check on your server side along with the callback URL, as in this example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://username:password@www.YourWebhookWebsite.com"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","isEvent":true,"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"],"pointer":"/paths/incomingFax/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"incomingFax","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"WebhookBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"incomingFax","href":"notifications/incomingfaxevent","openApiOperationId":"incomingFaxEvent","summary":"Incoming fax event"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"],"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_655","exampleIds":["paths/incomingFax/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_656","exampleIds":["paths/incomingFax/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Returns a 200 OK response if the webhook was received successfully."}],"pointer":"/paths/incomingFax/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/notifications/incomingfaxevent"}],"panels":[]}]},"httpPath":"incomingFax"},{"label":"Fax completed","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/docs/fax/api-reference/fax/notifications/faxcompletedcallback","routeSlug":"/docs/fax/api-reference/fax/notifications/faxcompletedcallback","metadata":{"seo":{"title":"Fax completed","description":"Triggered when the fax has been completed. The callback will contain information about the fax, such as the sender, the recipient, and the content of the fax. You must set the callback URL where you want the callback sent when you make a send fax request."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"faxCompletedCallback","name":"Fax completed","isWebhook":true,"pointer":"/paths/faxCompleted/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fax completed","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Triggered when the fax has been completed. The callback will contain information about the fax, such as the sender, the recipient, and the content of the fax. You must set the callback URL where you want the callback sent when you make a send fax request."},{"nodeType":"security","requirements":[{"schemes":[{"name":"WebhookBasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can validate whether a webhook is genuine by providing credentials you set and will check on your server side along with the callback URL, as in this example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://username:password@www.YourWebhookWebsite.com"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","isEvent":true,"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"],"pointer":"/paths/faxCompleted/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"faxCompleted","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"WebhookBasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"faxCompleted","href":"notifications/faxcompletedcallback","openApiOperationId":"faxCompletedCallback","summary":"Fax completed"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"],"mediaTypes":["multipart/form-data","application/json"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_657","exampleIds":["paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"]},"application/json":{"schemaId":"schema_658","exampleIds":["paths/faxCompleted/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Returns a 200 OK response if the webhook was received successfully."}],"pointer":"/paths/faxCompleted/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/notifications/faxcompletedcallback"}],"panels":[]}]},"httpPath":"faxCompleted"}],"content":{"contentType":"group","meta":{"name":"Notifications"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Notifications","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks allow you to get updates in real-time about the status of your faxes. Webhooks are triggered by events such as the completion of a fax, and transmit information about the state of that fax to you via HTTP(S) or email."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTP webhooks are multipart/form-data POST requests, and should be processed like form submissions."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" When webhooks with Basic authentication credentials are shown in GET requests, the credentials are masked with `***`` symbols. It is not possible to retrieve previously-set credentials through the API."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Webhooks","titleTranslationKey":"webhooks","items":[{"title":"incomingFax","summary":"Incoming fax event","prefix":{"name":"post","color":"post"},"badges":[],"link":"/notifications/incomingfaxevent","deprecated":false},{"title":"faxCompleted","summary":"Fax completed","prefix":{"name":"post","color":"post"},"badges":[],"link":"/notifications/faxcompletedcallback","deprecated":false}]}]}]}]}},{"type":"group","label":"Fax to Email","link":"/docs/fax/api-reference/fax/fax-to-email","routeSlug":"/docs/fax/api-reference/fax/fax-to-email","items":[{"type":"link","label":"Setting up fax to email","link":"/docs/fax/api-reference/fax/fax-to-email/setting-up-fax-to-email","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/setting-up-fax-to-email","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Setting up fax to email"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/setting-up-fax-to-email"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting up fax to email"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can configure fax to email in two different places:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In the dashboard on a number-by-number basis or by adding an email address and associating many numbers to one email address."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Via the API when you create a number or update a number, or by using the email endpoint to set it up directly"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported fax to email file types are Word, PDF, and TIF"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Fax to email example","link":"/docs/fax/api-reference/fax/fax-to-email/fax-to-email-example","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/fax-to-email-example","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Fax to email example"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/fax-to-email-example"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax to email example"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The following example shows how to configure Fax to Email using the API:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Buy a number in the dashboard and assign it to a Fax service"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add your email and associate it with the number you bought in step 1."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"POST https://fax.api.sinch.com/v3/projects/{projectId}/services/{serviceId}/emails\n {\n \"email\": \"user@domain.com\",\n \"phoneNumbers\": [\n {\n \"faxNumber\": \"+14155552222\",\n \"permissions\": \"both\"\n }\n ]\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"POST https://fax.api.sinch.com/v3/projects/{projectId}/services/{serviceId}/emails\n {\n \"email\": \"user@domain.com\",\n \"phoneNumbers\": [\n {\n \"faxNumber\": \"+14155552222\",\n \"permissions\": \"both\"\n }\n ]\n}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Now you can use your email client with the above email address to fax."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Send a fax using email","link":"/docs/fax/api-reference/fax/fax-to-email/send-a-fax-using-email","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/send-a-fax-using-email","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Send a fax using email"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/send-a-fax-using-email"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send a fax using email"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Make sure the email address you are sending from is added to your account. You can add it in the dashboard under the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax to email"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of your Fax service in the [Build dashboard]https://dashboard.sinch.com/fax/fax-to-email) or via the API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send an email to {PhoneNumberToSendFaxTo}@sinchfax.com with the following:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Subject:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you have multiple phone numbers associated with the email address, enter the number you want to use. If left blank, the first number that we find will be used."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Body:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default, the email body is not used."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attachments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add any attachments you want to fax. If you want to specify the order of pages we recommend that you create one document with all pages in the correct order and attach that document. If you attach multiple documents we will merge them into one document in the order we receive them."},"children":[]}]}]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Receive a fax using email","link":"/docs/fax/api-reference/fax/fax-to-email/receive-a-fax-using-email","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/receive-a-fax-using-email","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Receive a fax using email"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/receive-a-fax-using-email"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Receive a fax using email"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you receive a fax, we will send you an email with the following:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"From:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number the fax was sent from, e.g. +15612600684@sinchfax.com"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Subject:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You have received a new fax on {+1 234 555 5555}"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Body:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The page count and other metadata are HTML only, and will not appear in plain text in the email."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"There will be one PDF attachment with the fax content."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Configuring your email system for best performance","link":"/docs/fax/api-reference/fax/fax-to-email/configuring-your-email-system-for-best-performance","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/configuring-your-email-system-for-best-performance","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Configuring your email system for best performance"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/configuring-your-email-system-for-best-performance"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configuring your email system for best performance"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Make sure you allowlist "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sinchfax.com"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sinch.com"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in your spam filter to ensure delivery to your inbox, both on client and server side."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ensure your mail server is setup correctly and not on spam lists."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Encryption","link":"/docs/fax/api-reference/fax/fax-to-email/encryption","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/encryption","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Encryption"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"fax-to-email/encryption"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Encryption"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All emails are sent using TLS during transport from Sinch."},"children":[]}]}]}]}],"panels":[]}]}},{"label":"List emails for a number","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/getemailsfornumber","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/getemailsfornumber","metadata":{"seo":{"title":"List emails for a number","description":"List any emails for a number."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEmailsForNumber","name":"List emails for a number","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1emails/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List emails for a number","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List any emails for a number."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"phoneNumber","in":"path","schemaId":"schema_659","description":"The phone number you want to get emails for.","required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId containing the numbers you want to list.","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1emails/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_660","description":"The page to fetch. If not specified, the first page will be returned."},{"name":"pageSize","in":"query","schemaId":"schema_661","description":"Number of items to return on each page."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1emails/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/emails","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"phoneNumber","in":"path","required":true,"example":"+15612600684","schemaId":"schema_659"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"}],"query":[{"name":"page","in":"query","example":1,"schemaId":"schema_660"},{"name":"pageSize","in":"query","example":20,"schemaId":"schema_661"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/emails","href":"fax-to-email/getemailsfornumber","openApiOperationId":"getEmailsForNumber","summary":"List emails for a number","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to list emails associated with a phone number for\n const serviceId = 'FAX_SERVICE_ID';\n // The phone numbers you want to get emails for\n const phoneNumber ='PHONE_NUMBER';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxToEmail.listForNumber({\n serviceId,\n phoneNumber,\n });\n if (response.data.length === 0) {\n console.log('No Emails found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Emails.`);\n response.data.forEach((email) => {\n console.log(email);\n });\n } catch (err) {\n console.error(`❌ Failed to list the configured Emails associated with the phone number ${phoneNumber} and to the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A list of emails associated with the number.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_662"}},"schemaId":"schema_662"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1emails/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_662","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_662"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/getemailsfornumber"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/emails"},{"label":"List emails","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/getemailsforproject","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/getemailsforproject","metadata":{"seo":{"title":"List emails","description":"List emails for the project."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEmailsForProject","name":"List emails","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List emails","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List emails for the project."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_649","description":"The serviceId containing the emails you want to list.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page","in":"query","schemaId":"schema_660","description":"The page to fetch. If not specified, the first page will be returned."},{"name":"pageSize","in":"query","schemaId":"schema_661","description":"Number of items to return on each page."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/emails","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[{"name":"page","in":"query","example":1,"schemaId":"schema_660"},{"name":"pageSize","in":"query","example":20,"schemaId":"schema_661"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/emails","href":"fax-to-email/getemailsforproject","openApiOperationId":"getEmailsForProject","summary":"List emails","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to list emails for\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxToEmail.list({ serviceId });\n if (response.data.length === 0) {\n console.log('No Emails found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Emails.`);\n response.data.forEach((email) => {\n console.log(email);\n });\n } catch (err) {\n console.error(`❌ Failed to list Emails associated to the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A list of emails associated with the project.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_663"}},"schemaId":"schema_663"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_663","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_663"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/getemailsforproject"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/emails"},{"label":"Add an email","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/createemailforproject","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/createemailforproject","metadata":{"seo":{"title":"Add an email","description":"Add an email to the specified service to be used for sending and receiving faxes. Default settings for permissions parameter is both."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createEmailForProject","name":"Add an email","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add an email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add an email to the specified service to be used for sending and receiving faxes. Default settings for permissions parameter is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"both"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_649","description":"The serviceId to which you want to add the email.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Email","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/Email","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v3/projects/{projectId}/services/{serviceId}/emails","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Email","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"]}},"responseCodes":["201"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/emails","href":"fax-to-email/createemailforproject","openApiOperationId":"createEmailForProject","summary":"Add an email","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to add email for\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxToEmail.addToNumbers({\n serviceId,\n emailRequestBody: {\n email: 'user@domain.com',\n phoneNumbers: [\n {\n number: '+14155552222',\n permissions: 'both',\n },\n ],\n },\n });\n console.log('✅ Successfully added an Email to the Fax Service.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to add an Email to the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/Email","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Email","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"The added email","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Email"}},"schemaId":"components/schemas/Email"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Email","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Email"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/createemailforproject"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/emails"},{"label":"Update numbers for email","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/updateemail","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/updateemail","metadata":{"seo":{"title":"Update numbers for email","description":"Set the numbers for an email."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateEmail","name":"Update numbers for email","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update numbers for email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Set the numbers for an email."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"serviceId","in":"path","schemaId":"schema_649","description":"The serviceId containing the email you want to work with.","required":true},{"name":"email","in":"path","schemaId":"schema_649","description":"The email you want to work with.","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_664","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"]}},"schemaId":"schema_664","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"serviceId","in":"path","required":true,"schemaId":"schema_649"},{"name":"email","in":"path","required":true,"schemaId":"schema_649"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_664","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","href":"fax-to-email/updateemail","openApiOperationId":"updateEmail","summary":"Update numbers for email","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to update the email for\n const serviceId = 'FAX_SERVICE_ID';\n // The email address you want to update the phone numbers for\n const email ='EMAIL_ADDRESS';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxToEmail.update({\n serviceId,\n email,\n updateEmailRequestBody: {\n phoneNumbers: [\n {\n number: '+14155552222',\n permissions: 'both',\n },\n ],\n },\n });\n console.log('✅ Successfully updated the Phone Numbers.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to update the Phone Numbers associated with the Email ${email} from the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"schema_664","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_664","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The added email","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Email"}},"schemaId":"components/schemas/Email"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Email","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Email"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/updateemail"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}"},{"label":"Remove email","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/deleteemail","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/deleteemail","metadata":{"seo":{"title":"Remove email","description":"Delete an email and associated numbers to that email to disable that email from sending and receiving faxes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteEmail","name":"Remove email","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Delete an email and associated numbers to that email to disable that email from sending and receiving faxes."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"serviceId","in":"path","schemaId":"schema_649","description":"The serviceId containing the email you want to work with.","required":true},{"name":"email","in":"path","schemaId":"schema_649","description":"The email you want to work with.","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"serviceId","in":"path","required":true,"schemaId":"schema_649"},{"name":"email","in":"path","required":true,"schemaId":"schema_649"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["204"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","href":"fax-to-email/deleteemail","openApiOperationId":"deleteEmail","summary":"Remove email","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to remove the email from\n const serviceId = 'FAX_SERVICE_ID';\n // The email you want to remove\n const email ='EMAIL_ADDRESS';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n await sinch.fax.faxToEmail.delete({\n serviceId,\n email,\n });\n console.log(`✅ Successfully deleted the Email ${email} from the Fax Service with ID ${serviceId}.`);\n } catch (err) {\n console.error(`❌ Failed to delete the Email ${email} from the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No content: "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The email was deleted"},"children":[]}]}]}]}]}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/deleteemail"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}"},{"label":"Get numbers for email","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/fax-to-email/getnumbersbyemail","routeSlug":"/docs/fax/api-reference/fax/fax-to-email/getnumbersbyemail","metadata":{"seo":{"title":"Get numbers for email","description":"Get configured numbers for an email"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getNumbersByEmail","name":"Get numbers for email","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}~1numbers/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get numbers for email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get configured numbers for an email"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"serviceId","in":"path","schemaId":"schema_649","description":"The serviceId containing the email you want to work with.","required":true},{"name":"email","in":"path","schemaId":"schema_649","description":"The email you want to get numbers for.","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}~1numbers/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"pageSize","in":"query","schemaId":"schema_665","description":"Number of items to return on each page."},{"name":"page","in":"query","schemaId":"schema_649","description":"Optional. The page to fetch. If not specified, the first page will be returned."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}~1numbers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}/numbers","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"serviceId","in":"path","required":true,"schemaId":"schema_649"},{"name":"email","in":"path","required":true,"schemaId":"schema_649"}],"query":[{"name":"pageSize","in":"query","example":20,"schemaId":"schema_665"},{"name":"page","in":"query","schemaId":"schema_649"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}/numbers","href":"fax-to-email/getnumbersbyemail","openApiOperationId":"getNumbersByEmail","summary":"Get numbers for email","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to list phone numbers associated with an email address for\n const serviceId = 'FAX_SERVICE_ID';\n // The email address you want to get numbers for\n const email ='EMAIL_ADDRESS';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.faxToEmail.listNumbers({\n serviceId,\n email,\n });\n if (response.data.length === 0) {\n console.log('No Phone Numbers found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Phone Numbers.`);\n response.data.forEach((servicePhoneNumber) => {\n console.log(servicePhoneNumber);\n });\n } catch (err) {\n console.error(`❌ Failed to list the configured Phone Numbers associated with the Email address ${email} and to the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A list of numbers associated with the email","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_666"}},"schemaId":"schema_666"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}~1numbers/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_666","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_666"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fax-to-email/getnumbersbyemail"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}/numbers"}],"content":{"contentType":"group","meta":{"name":"Fax to Email"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fax to Email","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Emails endpoint allows you to configure the Fax to Email functionality. Fax to Email allows you to send an email and then receive a fax on your Sinch number or send a fax and have it sent to your email address."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The service supports sending incoming faxes to multiple email addresses and having many numbers associated with one email address."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/emails","summary":"List emails for a number","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fax-to-email/getemailsfornumber","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/emails","summary":"List emails","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fax-to-email/getemailsforproject","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/emails","summary":"Add an email","prefix":{"name":"post","color":"post"},"badges":[],"link":"/fax-to-email/createemailforproject","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","summary":"Update numbers for email","prefix":{"name":"put","color":"put"},"badges":[],"link":"/fax-to-email/updateemail","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}","summary":"Remove email","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/fax-to-email/deleteemail","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/emails/{email}/numbers","summary":"Get numbers for email","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fax-to-email/getnumbersbyemail","deprecated":false}]}]}]}]}},{"type":"group","label":"Domains","link":"/docs/fax/api-reference/fax/domains","routeSlug":"/docs/fax/api-reference/fax/domains","items":[{"label":"List domains","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/domains/listdomains","routeSlug":"/docs/fax/api-reference/fax/domains/listdomains","metadata":{"seo":{"title":"List domains","description":"List existing domains for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listDomains","name":"List domains","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List domains","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List existing domains for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the domains you want to list.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/domains","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains","href":"domains/listdomains","openApiOperationId":"listDomains","summary":"List domains","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The domains contained in the service.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DomainsListResponse"}},"schemaId":"components/schemas/DomainsListResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DomainsListResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DomainsListResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/domains/listdomains"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains"},{"label":"Create a domain","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/domains/createdomain","routeSlug":"/docs/fax/api-reference/fax/domains/createdomain","metadata":{"seo":{"title":"Create a domain","description":"Creates a new domain on the specified service to host email templates."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createDomain","name":"Create a domain","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a domain","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new domain on the specified service to host email templates."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId where you want to create a domain.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain to create.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["201"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","href":"domains/createdomain","openApiOperationId":"createDomain","summary":"Create a domain","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"The created domain.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateDomainResponse"}},"schemaId":"components/schemas/CreateDomainResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateDomainResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateDomainResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/domains/createdomain"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}"},{"label":"Get domain","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/domains/getdomain","routeSlug":"/docs/fax/api-reference/fax/domains/getdomain","metadata":{"seo":{"title":"Get domain","description":"Retrieve a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getDomain","name":"Get domain","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get domain","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the domain you want to retrieve.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain you want to retrieve.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","href":"domains/getdomain","openApiOperationId":"getDomain","summary":"Get domain","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The details of the domain.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DomainDetailsResponse"}},"schemaId":"components/schemas/DomainDetailsResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/DomainDetailsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/DomainDetailsResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/domains/getdomain"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}"},{"label":"Delete domain","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/domains/deletedomain","routeSlug":"/docs/fax/api-reference/fax/domains/deletedomain","metadata":{"seo":{"title":"Delete domain","description":"Delete a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteDomain","name":"Delete domain","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete domain","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Delete a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the domain you want to delete.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain you want to delete.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["204"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","href":"domains/deletedomain","openApiOperationId":"deleteDomain","summary":"Delete domain","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No content"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/domains/deletedomain"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}"},{"label":"Verify domain","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/domains/verifydomain","routeSlug":"/docs/fax/api-reference/fax/domains/verifydomain","metadata":{"seo":{"title":"Verify domain","description":"Verify a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"verifyDomain","name":"Verify domain","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}:verify/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Verify domain","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Verify a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the domain you want to verify.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain you want to verify.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}:verify/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}:verify","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}:verify","href":"domains/verifydomain","openApiOperationId":"verifyDomain","summary":"Verify domain","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The verification status of the domain.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VerifyDomainResponse"}},"schemaId":"components/schemas/VerifyDomainResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}:verify/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/VerifyDomainResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VerifyDomainResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/domains/verifydomain"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}:verify"}],"content":{"contentType":"group","meta":{"name":"Domains"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Domains","showPageActions":true},{"nodeType":"markdoc","content":"You can create email domains to handle the email notifications for your fax service. The operations in this endpoint allow you to create, manage, and verify your email domains."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/services/{serviceId}/domains","summary":"List domains","prefix":{"name":"get","color":"get"},"badges":[],"link":"/domains/listdomains","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","summary":"Create a domain","prefix":{"name":"post","color":"post"},"badges":[],"link":"/domains/createdomain","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","summary":"Get domain","prefix":{"name":"get","color":"get"},"badges":[],"link":"/domains/getdomain","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}","summary":"Delete domain","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/domains/deletedomain","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}:verify","summary":"Verify domain","prefix":{"name":"get","color":"get"},"badges":[],"link":"/domains/verifydomain","deprecated":false}]}]}]}]}},{"type":"group","label":"Templates","link":"/docs/fax/api-reference/fax/templates","routeSlug":"/docs/fax/api-reference/fax/templates","items":[{"label":"List templates for domain","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/templates/listtemplates","routeSlug":"/docs/fax/api-reference/fax/templates/listtemplates","metadata":{"seo":{"title":"List templates for domain","description":"List templates for a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listTemplates","name":"List templates for domain","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List templates for domain","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List templates for a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the templates you want to list.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain containing the templates you want to list.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates","href":"templates/listtemplates","openApiOperationId":"listTemplates","summary":"List templates for domain","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The returned templates.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplatesDomainNameResponse"}},"schemaId":"components/schemas/TemplatesDomainNameResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplatesDomainNameResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplatesDomainNameResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/listtemplates"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates"},{"label":"Get template","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/templates/gettemplate","routeSlug":"/docs/fax/api-reference/fax/templates/gettemplate","metadata":{"seo":{"title":"Get template","description":"Retrieve a named template for a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTemplate","name":"Get template","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve a named template for a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the templates you want to list.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain containing the template you want to get.","required":true},{"name":"templateName","in":"path","schemaId":"schema_669","description":"The name of the template you want to get.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"templateName","in":"path","required":true,"example":"successful outbound fax","schemaId":"components/schemas/TemplateName"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","href":"templates/gettemplate","openApiOperationId":"getTemplate","summary":"Get template","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The returned template.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateByNameResponse"}},"schemaId":"components/schemas/TemplateByNameResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplateByNameResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateByNameResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/gettemplate"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}"},{"label":"Update template","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/templates/updatetemplate","routeSlug":"/docs/fax/api-reference/fax/templates/updatetemplate","metadata":{"seo":{"title":"Update template","description":"Update a template for a specific domain for the specified service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateTemplate","name":"Update template","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update a template for a specific domain for the specified service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"serviceId","in":"path","schemaId":"schema_667","description":"The serviceId containing the templates you want to update.","required":true},{"name":"domainName","in":"path","schemaId":"schema_668","description":"The name of the domain containing the templates you want to update.","required":true},{"name":"templateName","in":"path","schemaId":"schema_669","description":"The name of the template you want to update.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTemplateRequest","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"]}},"schemaId":"components/schemas/UpdateTemplateRequest","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"serviceId","in":"path","required":true,"example":"01GVRB50KEQFFE1SGMPFRNBG6J","schemaId":"schema_667"},{"name":"domainName","in":"path","required":true,"example":"yourdomain.com","schemaId":"schema_668"},{"name":"templateName","in":"path","required":true,"example":"successful outbound fax","schemaId":"components/schemas/TemplateName"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateTemplateRequest","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"]}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","href":"templates/updatetemplate","openApiOperationId":"updateTemplate","summary":"Update template","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/UpdateTemplateRequest","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateTemplateRequest","exampleIds":["paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax","paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The updated template.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateByNameResponse"}},"schemaId":"components/schemas/TemplateByNameResponse"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplateByNameResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateByNameResponse"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/updatetemplate"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}"}],"content":{"contentType":"group","meta":{"name":"Templates"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Templates","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can use templates to control the look and content of the email notifications for your fax service. These templates are stored on a email domain that you can configure and manage using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/domains"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoints."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates","summary":"List templates for domain","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/listtemplates","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","summary":"Get template","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/gettemplate","deprecated":false},{"title":"/v3/projects/{projectId}/services/{serviceId}/domains/{domainName}/templates/{templateName}","summary":"Update template","prefix":{"name":"put","color":"put"},"badges":[],"link":"/templates/updatetemplate","deprecated":false}]}]}]}]}},{"type":"group","label":"Cover pages","link":"/docs/fax/api-reference/fax/cover-pages","routeSlug":"/docs/fax/api-reference/fax/cover-pages","items":[{"type":"link","label":"When cover pages are added","link":"/docs/fax/api-reference/fax/cover-pages/when-cover-pages-are-added","routeSlug":"/docs/fax/api-reference/fax/cover-pages/when-cover-pages-are-added","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"When cover pages are added"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"cover-pages/when-cover-pages-are-added"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When cover pages are added"},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Via dashboard","link":"/docs/fax/api-reference/fax/cover-pages/via-dashboard","routeSlug":"/docs/fax/api-reference/fax/cover-pages/via-dashboard","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Via dashboard"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"cover-pages/via-dashboard"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Via dashboard"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send Fax"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tab you can select the option to "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"select a cover page from a drop down"},"children":[]}]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When one is selected it will use that cover page on all outbound faxes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" If you are using Fax to Email, this is currently the only way to add a cover page to your faxes."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Via API","link":"/docs/fax/api-reference/fax/cover-pages/via-api","routeSlug":"/docs/fax/api-reference/fax/cover-pages/via-api","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Via API"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"cover-pages/via-api"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Via API"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When sending a fax using the API, you can specify "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"coverPageId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and supply your own cover page data."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"How to create a cover page","link":"/docs/fax/api-reference/fax/cover-pages/how-to-create-a-cover-page","routeSlug":"/docs/fax/api-reference/fax/cover-pages/how-to-create-a-cover-page","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"How to create a cover page"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"cover-pages/how-to-create-a-cover-page"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How to create a cover page"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a PDF that fits your brand. It should have all the standard static content you need to stay compliant. Insert tags that will be replaced at run time by us for dynamic content."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Automatic fields","link":"/docs/fax/api-reference/fax/cover-pages/automatic-fields","routeSlug":"/docs/fax/api-reference/fax/cover-pages/automatic-fields","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Automatic fields"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"cover-pages/automatic-fields"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Automatic fields"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If we find the tags described in the table below, we will replace these tokens with fax metadata."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Content"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{{from}}"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"string"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"+15557897890"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your Sinch number that you used to send the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{{to}}"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"string"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"+15551231234"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number to which you are sending the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{{date}}"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"date"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"2/4/2025"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the fax was sent."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{{pageCount}}"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"number"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"52"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total number of pages to be transmitted."},"children":[]}]}]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Specifying your own dynamic fields in API calls","link":"/docs/fax/api-reference/fax/cover-pages/specifying-your-own-dynamic-fields-in-api-calls","routeSlug":"/docs/fax/api-reference/fax/cover-pages/specifying-your-own-dynamic-fields-in-api-calls","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Specifying your own dynamic fields in API calls"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"cover-pages/specifying-your-own-dynamic-fields-in-api-calls"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifying your own dynamic fields in API calls"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When sending faxes via API you can add any tags you like with `{{}}`` syntax and set those in your app calls for cover page data."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you would like to add the recipient's name and your own message on the cover page:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"/// in your template pdf\nFax to : {{to_name}}\n{{my_custom_message}}\n\n{\n ///other fax fields removed for clarity\n coverPageData: {\n \"to_name\": \"Dr. John Smith\",\n \"my_custom_message\": \"I know you are busy please take on this patient\"\n }\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"/// in your template pdf\nFax to : {{to_name}}\n{{my_custom_message}}\n\n{\n ///other fax fields removed for clarity\n coverPageData: {\n \"to_name\": \"Dr. John Smith\",\n \"my_custom_message\": \"I know you are busy please take on this patient\"\n }\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"label":"Add cover page","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/cover-pages/addcoverpage","routeSlug":"/docs/fax/api-reference/fax/cover-pages/addcoverpage","metadata":{"seo":{"title":"Add cover page","description":"Add a cover page to your service"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addCoverPage","name":"Add cover page","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add cover page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Add a cover page to your service"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"the serviceId","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CoverPage"}},"schemaId":"components/schemas/CoverPage","pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v3/projects/{projectId}/services/{id}/coverPages","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CoverPage"}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/coverPages","href":"cover-pages/addcoverpage","openApiOperationId":"addCoverPage","summary":"Add cover page","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n // The Fax Service ID you want to add the Cover Page to\n const serviceId = 'FAX_SERVICE_ID';\n\n try {\n const response = await sinch.fax.coverPages.add({\n serviceId,\n addCoverPageRequestBody: {\n name: 'New cover page created with the Node.js SDK',\n file: {\n fileContent: 'V2VsY29tZSB0byBTaW5jaCE=',\n fileType: 'PDF',\n },\n },\n });\n console.log('✅ Successfully added a cover page to the Fax Service.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error('❌ Failed to add a cover page to the Fax Service:');\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/CoverPage","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CoverPage"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The added coverpage, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CoverPage"}},"schemaId":"components/schemas/CoverPage"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/CoverPage","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CoverPage"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cover-pages/addcoverpage"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/coverPages"},{"label":"List cover pages","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/cover-pages/listcoverpages","routeSlug":"/docs/fax/api-reference/fax/cover-pages/listcoverpages","metadata":{"seo":{"title":"List cover pages","description":"List all cover page to a service"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listCoverPages","name":"List cover pages","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List cover pages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List all cover page to a service"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"the serviceId","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{id}/coverPages","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/coverPages","href":"cover-pages/listcoverpages","openApiOperationId":"listCoverPages","summary":"List cover pages","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n // The Fax Service ID you want to list the Cover Page from\n const serviceId = 'FAX_SERVICE_ID';\n\n try {\n const response = await sinch.fax.coverPages.list({ serviceId });\n if (response.data.length === 0) {\n console.log('No Cover Pages found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Cover Pages.`);\n response.data.forEach((coverPage) => {\n console.log(coverPage);\n });\n } catch (err) {\n console.error('❌ Failed to list Cover Pages:');\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of coverpages "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_670"}},"schemaId":"schema_670"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_670","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_670"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cover-pages/listcoverpages"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/coverPages"},{"label":"Delete a cover page","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/cover-pages/deletecoverpage","routeSlug":"/docs/fax/api-reference/fax/cover-pages/deletecoverpage","metadata":{"seo":{"title":"Delete a cover page","description":"Remove delete a cover page from a service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteCoverPage","name":"Delete a cover page","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a cover page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Remove delete a cover page from a service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId containing the cover page you want to work with.","required":true},{"name":"coverPageId","in":"path","schemaId":"schema_671","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"coverPageId","in":"path","required":true,"schemaId":"schema_671"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["204"],"pointer":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","href":"cover-pages/deletecoverpage","openApiOperationId":"deleteCoverPage","summary":"Delete a cover page","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to delete a Cover Page from\n const serviceId = 'FAX_SERVICE_ID';\n // The Cover Page ID you want to delete\n const coverPageId = 'COVER_PAGE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n await sinch.fax.coverPages.delete({ serviceId, coverPageId });\n console.log(`✅ Successfully deleted the Cover Page with ID ${coverPageId} from the Fax Service with ID ${serviceId}.`);\n } catch (err) {\n console.error(`❌ Failed to delete the Cover Page with ID ${coverPageId} from the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The cover page was deleted."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cover-pages/deletecoverpage"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}"},{"label":"Get a cover page","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/cover-pages/getcoverpage","routeSlug":"/docs/fax/api-reference/fax/cover-pages/getcoverpage","metadata":{"seo":{"title":"Get a cover page","description":"Get a cover page by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCoverPage","name":"Get a cover page","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a cover page","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a cover page by ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId containing the cover page you want to work with.","required":true},{"name":"coverPageId","in":"path","schemaId":"schema_671","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"coverPageId","in":"path","required":true,"schemaId":"schema_671"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","href":"cover-pages/getcoverpage","openApiOperationId":"getCoverPage","summary":"Get a cover page","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to retrieve a Cover Page from\n const serviceId = 'FAX_SERVICE_ID';\n // The Cover Page ID you want to retrieve\n const coverPageId = 'COVER_PAGE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.coverPages.get({ serviceId, coverPageId });\n console.log('✅ Successfully retrieved the Cover Page.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to retrieve the Cover Page with ID ${coverPageId} from the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requested cover page, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CoverPage"}},"schemaId":"components/schemas/CoverPage"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1coverPages~1{coverPageId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/CoverPage","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CoverPage"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cover-pages/getcoverpage"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}"}],"content":{"contentType":"group","meta":{"name":"Cover pages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cover pages","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can add cover pages to Sinch Fax either via the API or the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Fax service can have 0 or more cover pages configured."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/services/{id}/coverPages","summary":"Add cover page","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cover-pages/addcoverpage","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}/coverPages","summary":"List cover pages","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cover-pages/listcoverpages","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","summary":"Delete a cover page","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/cover-pages/deletecoverpage","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}/coverPages/{coverPageId}","summary":"Get a cover page","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cover-pages/getcoverpage","deprecated":false}]}]}]}]}},{"type":"group","label":"Error Messages","link":"/docs/fax/api-reference/fax/error-messages","routeSlug":"/docs/fax/api-reference/fax/error-messages","items":[{"type":"link","label":"Fax Error Messages","link":"/docs/fax/api-reference/fax/error-messages/fax-error-messages","routeSlug":"/docs/fax/api-reference/fax/error-messages/fax-error-messages","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Fax Error Messages"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"error-messages/fax-error-messages"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax Error Messages"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When your receive a callback from the fax api notifying you of a failure, it will contain two values"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that can help you understand what went wrong: an errorCode and an type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type will give you a general idea of why the operation failed, whereas the errorCode describes the issue in more detail. Below we list the error_codes for the API, segmented by their corresponding error_type."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"partials/fax/errors/_schemas.md","variables":{"$$apiDocsHeadingScope":{"operationId":"error-messages"}}},"children":[]}]}],"panels":[]}]}},{"type":"link","label":"General Error Messages","link":"/docs/fax/api-reference/fax/error-messages/general-error-messages","routeSlug":"/docs/fax/api-reference/fax/error-messages/general-error-messages","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"General Error Messages"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"error-messages/general-error-messages"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"General Error Messages"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request errors are returned as HTTP status codes. The following table lists the possible error codes and their meaning."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type will give you a general idea of why the operation failed, whereas the errorCode describes the issue in more detail. Below we list the error_codes for the API, segmented by their corresponding error_type."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Http Error Codes","link":"/docs/fax/api-reference/fax/error-messages/http-error-codes","routeSlug":"/docs/fax/api-reference/fax/error-messages/http-error-codes","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Http Error Codes"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"error-messages/http-error-codes"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Http Error Codes"},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"400 - Bad Request","link":"/docs/fax/api-reference/fax/error-messages/400-bad-request","routeSlug":"/docs/fax/api-reference/fax/error-messages/400-bad-request","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"400 - Bad Request"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/400-bad-request"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"400 - Bad Request"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"code\": \"404\",\n \"error\": \"Bad Request\",\n \"message\": \"\n The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.\n It could be invalid JSON, missing required fields, or other issues.\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"code\": \"404\",\n \"error\": \"Bad Request\",\n \"message\": \"\n The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.\n It could be invalid JSON, missing required fields, or other issues.\"\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"401 - Unauthorized","link":"/docs/fax/api-reference/fax/error-messages/401-unauthorized","routeSlug":"/docs/fax/api-reference/fax/error-messages/401-unauthorized","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"401 - Unauthorized"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/401-unauthorized"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"401 - Unauthorized"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Empty body, or you have the wrong API key, secret, or project."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"402 - Payment required","link":"/docs/fax/api-reference/fax/error-messages/402-payment-required","routeSlug":"/docs/fax/api-reference/fax/error-messages/402-payment-required","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"402 - Payment required"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/402-payment-required"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"402 - Payment required"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"code\": \"402\",\n \"error\": \"Payment required\",\n \"message\": \"You have reached 0 balance on your account please make a payment.\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"code\": \"402\",\n \"error\": \"Payment required\",\n \"message\": \"You have reached 0 balance on your account please make a payment.\"\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"404 - Not found","link":"/docs/fax/api-reference/fax/error-messages/404-not-found","routeSlug":"/docs/fax/api-reference/fax/error-messages/404-not-found","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"404 - Not found"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/404-not-found"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"404 - Not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"code\": \"404\",\n \"error\": \"Not found\",\n \"message\": \"The resource is not found, not available, or does not exist.\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"code\": \"404\",\n \"error\": \"Not found\",\n \"message\": \"The resource is not found, not available, or does not exist.\"\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"422 - Unprocessable Content (Invalid parameters)","link":"/docs/fax/api-reference/fax/error-messages/422-unprocessable-content-(invalid-parameters)","routeSlug":"/docs/fax/api-reference/fax/error-messages/422-unprocessable-content-(invalid-parameters)","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"422 - Unprocessable Content (Invalid parameters)"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/422-unprocessable-content-(invalid-parameters)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"422 - Unprocessable Content (Invalid parameters)"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"code\": \"422\",\n \"error\": \"Invalid parameters\",\n \"message\": \"The request could not be understood by the server due to malformed syntax.\n The client SHOULD NOT repeat the request without modifications.\"\n details: {\n fieldViolations: [\n {\n field: \"to\",\n description: \"The (+15551) is not a valid phone number\"\n }\n ]\n\n }\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"code\": \"422\",\n \"error\": \"Invalid parameters\",\n \"message\": \"The request could not be understood by the server due to malformed syntax.\n The client SHOULD NOT repeat the request without modifications.\"\n details: {\n fieldViolations: [\n {\n field: \"to\",\n description: \"The (+15551) is not a valid phone number\"\n }\n ]\n\n }\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"429 Rate limit exceeded","link":"/docs/fax/api-reference/fax/error-messages/429-rate-limit-exceeded","routeSlug":"/docs/fax/api-reference/fax/error-messages/429-rate-limit-exceeded","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"429 Rate limit exceeded"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/429-rate-limit-exceeded"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"429 Rate limit exceeded"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rate limit exceeded, please back off and try again later. If you need higher rate please contact support."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"500 - Internal Server Error","link":"/docs/fax/api-reference/fax/error-messages/500-internal-server-error","routeSlug":"/docs/fax/api-reference/fax/error-messages/500-internal-server-error","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"500 - Internal Server Error"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/500-internal-server-error"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500 - Internal Server Error"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Probably no body, but if there is a body it will look like this:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"code\": \"500\",\n \"error\": \"Internal service error\",\n \"message\": \"Most likely a temporary issue, please try again later. If the problem persists, please back of on this request and contact support.\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"code\": \"500\",\n \"error\": \"Internal service error\",\n \"message\": \"Most likely a temporary issue, please try again later. If the problem persists, please back of on this request and contact support.\"\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"800 - URL Connection Error","link":"/docs/fax/api-reference/fax/error-messages/800-url-connection-error","routeSlug":"/docs/fax/api-reference/fax/error-messages/800-url-connection-error","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"800 - URL Connection Error"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"error-messages/800-url-connection-error"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"800 - URL Connection Error"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This non-http code will be used when there is an issue connecting to the designated callback URL. The response will look like this:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"{\n \"error\": \"Could not connect to URL: https://123.456.789.00\"\n}\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"{\n \"error\": \"Could not connect to URL: https://123.456.789.00\"\n}\n"},"children":[]}]}]}],"panels":[]}]}},{"type":"link","label":"Error object","link":"/docs/fax/api-reference/fax/error-messages/error-object","routeSlug":"/docs/fax/api-reference/fax/error-messages/error-object","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Error object"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"error-messages/error-object"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error object"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note that the response code is probably the most important part of the response, but the error object will contain more information about the error."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not all errors return this object, and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object is not always present."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"json-example","attributes":{"value":{"$ref":"./fax.yaml#/components/schemas/Error"},"valueResolved":{"type":"object","properties":{"code":{"description":"HTTP status code or error code","readOnly":true,"type":"integer","format":"int32","example":400},"status":{"description":"Response status name.","readOnly":true,"type":"string","example":"INVALID_ARGUMENT"},"message":{"type":"string","readOnly":true,"description":"A developer-facing error message","example":"Bad request."},"details":{"readOnly":true,"description":"Details of the errors","type":"array","items":{"type":"object","allOf":[{"$ref":"#/components/schemas/ErrorDetail"}]}}}}},"children":[]}]}],"panels":[]}]}}],"content":{"contentType":"group","meta":{"name":"Error Messages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Error Messages","showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/error-messages"}],"panels":[]}]}},{"type":"group","label":"Services","link":"/docs/fax/api-reference/fax/services","routeSlug":"/docs/fax/api-reference/fax/services","items":[{"type":"link","label":"Dashboard","link":"/docs/fax/api-reference/fax/services/dashboard","routeSlug":"/docs/fax/api-reference/fax/services/dashboard","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Dashboard"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"services/dashboard"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dashboard"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can manage all your fax services and their settings via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/fax/services"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Sending a test fax","link":"/docs/fax/api-reference/fax/services/sending-a-test-fax","routeSlug":"/docs/fax/api-reference/fax/services/sending-a-test-fax","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Sending a test fax"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"services/sending-a-test-fax"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sending a test fax"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To send a TEST Inbound fax event in the Dashboard, enter the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IncomingWebhookUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the Incoming tab and click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Save"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Then click the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SEND TEST REQUEST"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" button. This will emulate all aspects of a real INCOMING fax event without charging your account."},"children":[]}]}]}]}],"panels":[]}]}},{"label":"Create a service","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/createservice","routeSlug":"/docs/fax/api-reference/fax/services/createservice","metadata":{"seo":{"title":"Create a service","description":"Creates a new service that you can use to set default configuration values."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createService","name":"Create a service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new service that you can use to set default configuration values."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Service"}},"schemaId":"components/schemas/Service","pointer":"/paths/~1v3~1projects~1{projectId}~1services/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v3/projects/{projectId}/services","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Service"}},"responseCodes":["201"],"pointer":"/v3/projects/{projectId}/services","href":"services/createservice","openApiOperationId":"createService","summary":"Create a service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.services.create({\n createServiceRequestBody: {\n name: 'My new Fax Service',\n defaultForProject: true,\n },\n });\n console.log('✅ Successfully created the Fax Service.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error('❌ Failed to create the Fax Service:');\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/Service","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Service"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"The newly created service","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}},"schemaId":"components/schemas/Service"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Service","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/createservice"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services"},{"label":"List services","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/listservices","routeSlug":"/docs/fax/api-reference/fax/services/listservices","metadata":{"seo":{"title":"List services","description":"Get a list of services for a project."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listServices","name":"List services","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List services","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a list of services for a project."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"pageSize","in":"query","schemaId":"schema_665","description":"Number of services to return on each request."},{"name":"page","in":"query","schemaId":"schema_649","description":"Optional. The page to fetch. If not specified, the first page will be returned."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[{"name":"pageSize","in":"query","example":20,"schemaId":"schema_665"},{"name":"page","in":"query","schemaId":"schema_649"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services","href":"services/listservices","openApiOperationId":"listServices","summary":"List services","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.services.list({});\n if (response.data.length === 0) {\n console.log('No Fax Services found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Fax Services.`);\n response.data.forEach((faxService) => {\n console.log(faxService);\n });\n } catch (err) {\n console.error('❌ Failed to list Fax Services:');\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of services, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_672"}},"schemaId":"schema_672"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_672","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_672"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/listservices"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services"},{"label":"Get a service","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/getservice","routeSlug":"/docs/fax/api-reference/fax/services/getservice","metadata":{"seo":{"title":"Get a service","description":"Get a service resource."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getService","name":"Get a service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a service resource."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_649","description":"The service ID you want to update.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{id}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}","href":"services/getservice","openApiOperationId":"getService","summary":"Get a service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to retrieve\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.services.get({ serviceId });\n console.log('✅ Successfully retrieved the Fax Service.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to retrieve the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requested service, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}},"schemaId":"components/schemas/Service"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Service","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/getservice"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}"},{"label":"Update a Service","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/updateservice","routeSlug":"/docs/fax/api-reference/fax/services/updateservice","metadata":{"seo":{"title":"Update a Service","description":"Update settings on the service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateService","name":"Update a Service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a Service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update settings on the service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_649","description":"The service ID you want to update.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Service"}},"schemaId":"components/schemas/Service","pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/v3/projects/{projectId}/services/{id}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Service"}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}","href":"services/updateservice","openApiOperationId":"updateService","summary":"Update a Service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to update\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.services.update({\n serviceId,\n updateServiceRequestBody: {\n name: 'My updated Fax Service name',\n },\n });\n console.log('✅ Successfully updated the Fax Service.');\n console.log(JSON.stringify(response, null, 2));\n } catch (err) {\n console.error(`❌ Failed to update the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/Service","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Service"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The updated service, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}},"schemaId":"components/schemas/Service"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Service","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Service"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/updateservice"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}"},{"label":"Remove a service","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/removeservice","routeSlug":"/docs/fax/api-reference/fax/services/removeservice","metadata":{"seo":{"title":"Remove a service","description":"Removes a service from your project."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeService","name":"Remove a service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/delete","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove a service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Removes a service from your project."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId you want to remove from your project.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/v3/projects/{projectId}/services/{id}","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["204"],"pointer":"/v3/projects/{projectId}/services/{id}","href":"services/removeservice","openApiOperationId":"removeService","summary":"Remove a service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to delete\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n await sinch.fax.services.delete({ serviceId });\n console.log(`✅ Successfully deleted the Fax Service with ID ${serviceId}.`);\n } catch (err) {\n console.error(`❌ Failed to delete the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The service removed from the project, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}]}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/removeservice"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}"},{"label":"List numbers for service","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/listnumbersforservice","routeSlug":"/docs/fax/api-reference/fax/services/listnumbersforservice","metadata":{"seo":{"title":"List numbers for service","description":"List numbers for a service."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listNumbersForService","name":"List numbers for service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers/get","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List numbers for service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List numbers for a service."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId containing the numbers you want to list.","required":true},{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"pageSize","in":"query","schemaId":"schema_665","description":"Number of items to return on each page."},{"name":"page","in":"query","schemaId":"schema_649","description":"Optional. The page to fetch. If not specified, the first page will be returned."}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v3/projects/{projectId}/services/{id}/numbers","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_649"},{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"}],"query":[{"name":"pageSize","in":"query","example":20,"schemaId":"schema_665"},{"name":"page","in":"query","schemaId":"schema_649"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/numbers","href":"services/listnumbersforservice","openApiOperationId":"listNumbersForService","summary":"List numbers for service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"definitionSamples":[{"lang":"Node.js","source":"/**\n * Sinch Node.js Snippet\n * See: https://github.com/sinch/sinch-sdk-node/examples/snippets\n */\nimport { SinchClient } from '@sinch/sdk-core';\nimport * as dotenv from 'dotenv';\ndotenv.config();\n\nasync function main() {\n const projectId = process.env.SINCH_PROJECT_ID ?? 'MY_PROJECT_ID';\n const keyId = process.env.SINCH_KEY_ID ?? 'MY_KEY_ID';\n const keySecret = process.env.SINCH_KEY_SECRET ?? 'MY_KEY_SECRET';\n\n // The Fax Service ID you want to list numbers for\n const serviceId = 'FAX_SERVICE_ID';\n\n const sinch = new SinchClient({ projectId, keyId, keySecret });\n\n try {\n const response = await sinch.fax.services.listNumbers({ serviceId });\n if (response.data.length === 0) {\n console.log('No Phone Numbers found.');\n return;\n }\n console.log(`✅ Found ${response.data.length} Phone Numbers.`);\n response.data.forEach((servicePhoneNumber) => {\n console.log(servicePhoneNumber);\n });\n } catch (err) {\n console.error(`❌ Failed to list the Phone Numbers for the Fax Service with ID ${serviceId}:`);\n console.error(err);\n }\n}\n\nmain();\n"}],"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of numbers, or an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_673"}},"schemaId":"schema_673"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_673","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_673"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/listnumbersforservice"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/numbers"},{"label":"Suspend a number on the service","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/docs/fax/api-reference/fax/services/suspendnumber","routeSlug":"/docs/fax/api-reference/fax/services/suspendnumber","metadata":{"seo":{"title":"Suspend a number on the service","description":"Suspends a number assigned to the specified service. You can include a note as to the reason of the suspension."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"suspendNumber","name":"Suspend a number on the service","isWebhook":false,"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1suspend/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suspend a number on the service","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Suspends a number assigned to the specified service. You can include a note as to the reason of the suspension."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]}]},{"schemes":[{"name":"OAuth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"projectId","in":"path","schemaId":"schema_638","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"projectId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a required parameter you must include when making any API calls. You can find your project ID on your "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Build dashboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true},{"name":"phoneNumber","in":"path","schemaId":"schema_659","description":"The phone number you want to suspend.","required":true},{"name":"id","in":"path","schemaId":"schema_649","description":"The serviceId containing the numbers you want to suspend.","required":true}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1suspend/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SuspendRequest"}},"schemaId":"components/schemas/SuspendRequest","pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1suspend/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/suspend","servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"parameters":{"path":[{"name":"projectId","in":"path","required":true,"example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47","schemaId":"schema_638"},{"name":"phoneNumber","in":"path","required":true,"example":"+15612600684","schemaId":"schema_659"},{"name":"id","in":"path","required":true,"schemaId":"schema_649"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]},{"schemes":[{"id":"OAuth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SuspendRequest"}},"responseCodes":["200"],"pointer":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/suspend","href":"services/suspendnumber","openApiOperationId":"suspendNumber","summary":"Suspend a number on the service","securityGroups":[{"BasicAuth":[]},{"OAuth2":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"schemaId":"components/schemas/SuspendRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SuspendRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Response detailing the suspended number.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ServicePhoneNumber"}},"schemaId":"components/schemas/ServicePhoneNumber"}],"pointer":"/paths/~1v3~1projects~1{projectId}~1services~1{id}~1numbers~1{phoneNumber}~1suspend/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/ServicePhoneNumber","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ServicePhoneNumber"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/services/suspendnumber"}],"panels":[]}]},"httpPath":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/suspend"}],"content":{"contentType":"group","meta":{"name":"Services"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Services","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A fax service identifies a set of configuration values. You can specify the service as a part of an API request or by associating a Sinch number with a service."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This can be useful if you want to point a group of numbers to a particular incoming fax URL, or want to set the storage strategy for some of your numbers but not all of them."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v3/projects/{projectId}/services","summary":"Create a service","prefix":{"name":"post","color":"post"},"badges":[],"link":"/services/createservice","deprecated":false},{"title":"/v3/projects/{projectId}/services","summary":"List services","prefix":{"name":"get","color":"get"},"badges":[],"link":"/services/listservices","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}","summary":"Get a service","prefix":{"name":"get","color":"get"},"badges":[],"link":"/services/getservice","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}","summary":"Update a Service","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/services/updateservice","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}","summary":"Remove a service","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/services/removeservice","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}/numbers","summary":"List numbers for service","prefix":{"name":"get","color":"get"},"badges":[],"link":"/services/listnumbersforservice","deprecated":false},{"title":"/v3/projects/{projectId}/services/{id}/numbers/{phoneNumber}/suspend","summary":"Suspend a number on the service","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/services/suspendnumber","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Number":{"id":"components/schemas/Number","kind":"json-schema","title":"Number","data":{"description":"A phone number and its permissions.","type":"object","properties":{"faxNumber":{"$ref":"#/components/schemas/PhoneNumber"},"permissions":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"both"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"x-enumDescriptions":{"both":"Allows the email to send and receive faxes to this email/phone number combination.","send":"Allows the email to only send faxes to this email/phone number combination.","receive":"Allows the email to only receive faxes from this email/phone number combination."},"enum":["both","send","receive"],"default":"both"}}}},"components/schemas/Email":{"id":"components/schemas/Email","kind":"json-schema","title":"Email","data":{"type":"object","required":["email","phoneNumbers"],"properties":{"email":{"type":"string","format":"email","example":"user@domain.com"},"phoneNumbers":{"description":"Numbers you want to associate with this email.","type":"array","items":{"$ref":"#/components/schemas/Number"}},"projectId":{"readOnly":true,"x-version":1,"allOf":[{"$ref":"#/components/schemas/ProjectId"}]},"createdAt":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the email configuration was created."},"updatedAt":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the email configuration was last updated."}}}},"components/schemas/TemplateName":{"id":"components/schemas/TemplateName","kind":"json-schema","title":"TemplateName","data":{"type":"string","description":"The name of the email template.","enum":["successful outbound fax","unsuccessful outbound fax","successful inbound fax","unsuccessful inbound fax"],"x-enumDescriptions":{"successful outbound fax":"The template for a successful outbound fax.","unsuccessful outbound fax":"The template for an unsuccessful outbound fax.","successful inbound fax":"The template for a successful inbound fax.","unsuccessful inbound fax":"The template for an unsuccessful inbound fax."},"example":"successful outbound fax"}},"components/schemas/FaxDirection":{"id":"components/schemas/FaxDirection","kind":"json-schema","title":"FaxDirection","data":{"type":"string","description":"The direction of the fax.","readOnly":true,"enum":["OUTBOUND","INBOUND"],"x-enumDescriptions":{"OUTBOUND":"The fax was sent by you via the API.","INBOUND":"The fax was received on one of your numbers."},"example":"OUTBOUND"}},"components/schemas/Fax":{"id":"components/schemas/Fax","kind":"json-schema","title":"Fax","data":{"type":"object","properties":{"id":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/FaxId"}]},"direction":{"allOf":[{"$ref":"#/components/schemas/FaxDirection"}],"readOnly":true},"from":{"allOf":[{"$ref":"#/components/schemas/PhoneNumber"}],"readOnly":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INBOUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" faxes, this is the number where the fax is sent from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OUTBOUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" faxes, this is the Sinch number you want to have as sender"},"children":[]}]}]}]},"to":{"allOf":[{"$ref":"#/components/schemas/PhoneNumber"}],"readOnly":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INBOUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" faxes, this is the Sinch number someone sent the fax to."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OUTBOUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" faxes, this is the phone number you want to send a fax to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can add multiple numbers by adding them as an array. For example:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/json"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"\"to\": [\"+14155552222\", \"+14155553333\"]\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"\"to\": [\"+14155552222\", \"+14155553333\"]\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"multipart/form"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"to=+14155552222&to=+14155553333\n\n","language":"json"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"to=+14155552222&to=+14155553333\n\n"},"children":[]}]}]},"contentUrl":{"anyOf":[{"type":"string","format":"url","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single URL. Fetched documents must be one of the following file types: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".docx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"html."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".jpg"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".png"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".tif"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".txt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://example.com/fax.pdf"},{"type":"array","items":{"type":"string","format":"url"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multiple URLs. Fetched documents must be one of the following file types: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".docx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"html."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".jpg"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".png"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".tif"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".txt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":["https://www.google.com","https://www.sinch.com"]}],"format":"URL","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Give us any URL on the Internet (including ones with basic authentication)"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one file or contentUrl parameter is required."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note: If you are passing fax a secure URL (starting with https://), make sure that your SSL certificate (including your intermediate cert, if you have one) is installed properly, valid, and up-to-date."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the file parameter is specified as well, content from URLs will be rendered before content from files."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can add multiple URLs by adding them as an array them with a comma when posting as multipart/form-data"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example: \"https://developers.sinch.com/fax/fax.pdf, https://developers.sinch.com/\" or if posting JSON "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"contentUrl\": [\"https://developers.sinch.com/fax/fax.pdf\", \"https://developers.sinch.com/\"]"},"children":[]}]}]}],"example":"https://developers.sinch.com/fax/fax.pdf"},"numberOfPages":{"type":"integer","readOnly":true,"description":"The number of pages in the fax."},"status":{"$ref":"#/components/schemas/FaxStatus"},"price":{"description":"The total price for this fax. This field is populated after the final fax price is calculated.","allOf":[{"$ref":"#/components/schemas/Money"}],"readOnly":true},"barCodes":{"description":"The bar codes found in the fax. This field is populated when Sinch detects bar codes on incoming faxes.","readOnly":true,"type":"array","items":{"$ref":"#/components/schemas/BarCode"}},"createTime":{"readOnly":true,"type":"string","format":"date-time","description":"A timestamp representing the time when the initial API call was made."},"completedTime":{"type":"string","format":"date-time","readOnly":true,"description":"If the job is complete, this is a timestamp representing the time the job was completed."},"pagesSentSuccessfully":{"type":"integer","description":"The number of pages successfully sent to the receiving side in the fax.","readOnly":true,"example":3},"headerText":{"description":"Text that will be displayed at the top of each page of the fax. 50 characters maximum. Default header text is \"-\". Note that the header is not applied until the fax is transmitted, so it will not appear on fax PDFs or thumbnails.","type":"string","maximum":50,"default":""},"headerPageNumbers":{"type":"boolean","description":"If true, page numbers will be displayed in the header. Default is true.","default":true},"headerTimeZone":{"type":"string","format":"timezone","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/List_of_tz_database_time_zones"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TZ database name"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" string specifying the timezone for the header timestamp."},"children":[]}]}]}],"default":"America/New_York"},"retryDelaySeconds":{"description":"The number of seconds to wait between retries if the fax is not yet completed.","type":"integer","minimum":30,"maximum":300,"default":60},"labels":{"x-version":2,"description":"You can use this to attach labels to your call that you can use in your BI solutions.","allOf":[{"$ref":"#/components/schemas/Labels"}],"example":{"customerId":"1234","customerName":"John Doe"}},"callbackUrl":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL to which a callback will be sent when the fax is completed. The callback will be sent as a POST request with a JSON body. The callback will be sent to the URL specified in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"callbackUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter, if provided, otherwise it will be sent to the URL specified in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"callbackUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field of the Fax Service object."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: If a callback URL uses basicauth credentials, when the callback URL is retrieved those credentials are masked. It is not possible to retrieve previously-set credentials through the API."},"children":[]}]}]}],"format":"URL","example":"https://www.my-website.com/callback"},"callbackUrlContentType":{"description":"The content type of the callback.","type":"string","default":"multipart/form-data","enum":["multipart/form-data","application/json"],"x-enumDescriptions":{"multipart/form-data":"The callback will be sent as a multipart/form-data request with files as attachments to the body.","application/json":"The callback will be sent as a JSON request with the files as base64 encoded strings in the JSON object."}},"imageConversionMethod":{"$ref":"#/components/schemas/ImageConversionMethod"},"errorType":{"readOnly":true,"allOf":[{"$ref":"#/components/schemas/ErrorType"}]},"errorCode":{"readOnly":true,"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One of the error numbers listed in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax Error Messages section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"errorMessage":{"readOnly":true,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One of the error codes listed in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/error-messages"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fax Error Messages section"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"maxRetries":{"readOnly":false,"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"| The number of times the fax will be retired before cancel. Default value is set in your fax service."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"| The maximum number of retries is 5."},"children":[]}]}]}],"maximum":5,"minimum":0},"retryCount":{"readOnly":true,"type":"integer","description":"The number of times the fax has been retried."},"hasFile":{"readOnly":true,"type":"boolean","description":"Only shown on the fax result. This indicates if the content of the fax is stored with Sinch. (true or false)"},"resolution":{"$ref":"#/components/schemas/Resolution"},"coverPageId":{"type":"string","description":"The cover page id you want to use for the fax"},"coverPageData":{"$ref":"#/components/schemas/CoverPageData"},"inProgressNotifications":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you will receive a webhook notification for each page sent on an outbound fax."},"children":[]}]}]}],"default":false},"fromCountry":{"readOnly":true,"type":"string","description":"The country code in ISO 3166-1 alpha-2 format of the number sending the fax.","example":"US"},"toCountry":{"readOnly":true,"type":"string","description":"The country code in ISO 3166-1 alpha-2 format of the number receiving the fax.","example":"US"},"projectId":{"readOnly":true,"x-version":1,"allOf":[{"$ref":"#/components/schemas/ProjectId"}]},"serviceId":{"readOnly":false,"x-version":1,"allOf":[{"$ref":"#/components/schemas/ServiceId"}]}}}},"components/schemas/FaxBase64Array":{"id":"components/schemas/FaxBase64Array","kind":"json-schema","title":"FaxBase64Array","data":{"description":"An array of base64 encoded files","type":"object","properties":{"files":{"type":"array","description":"An array of base64 encoded files","items":{"$ref":"#/components/schemas/FaxBase64File"}}}}},"components/schemas/FaxBase64File":{"id":"components/schemas/FaxBase64File","kind":"json-schema","title":"FaxBase64File","data":{"type":"object","properties":{"file":{"type":"string","format":"base64","contentEncoding":"base64","description":"When application/json Base64 encoded file content, this is only present when using application/json for request/response.","example":"{base64-encoded content}"},"fileType":{"$ref":"#/components/schemas/FileTypeJson"}}}},"components/schemas/FileTypeMultiPart":{"id":"components/schemas/FileTypeMultiPart","kind":"json-schema","title":"FileTypeMultiPart","data":{"description":"When request/response is multipart/form-data and file is part of payload. This is the file type of the file.","enum":["application/docx","application/pdf","application/tif","application/jpg","application/txt","application/html","application/png"],"x-enumDescriptions":{"application/docx":"Microsoft Word","application/pdf":"PDF","application/tif":"TIFF","application/jpg":"JPEG","application/txt":"Text","application/html":"HTML","application/png":"PNG"}}},"components/schemas/FileTypeJson":{"id":"components/schemas/FileTypeJson","kind":"json-schema","title":"FileTypeJson","data":{"type":"string","description":"When request/response is application/json and file is part of payload. This is the file type of the file.","enum":["DOCX","PDF","TIF","JPG","TXT","HTML","PNG"],"x-enumDescriptions":{"DOCX":"Microsoft Word","PDF":"PDF","TIF":"TIFF","JPG":"JPEG","TXT":"Text","HTML":"HTML","PNG":"PNG"}}},"components/schemas/BarCode":{"id":"components/schemas/BarCode","kind":"json-schema","title":"BarCode","data":{"type":"object","description":"Sinch will scan all pages of all incoming faxes for Code-128 and DataMatrix bar codes and include this information in webhook requests and via the API.","properties":{"type":{"type":"string","description":"The type of barcode found.","enum":["CODE_128","DATA_MATRIX"],"x-enumDescriptions":{"CODE_128":"Code-128 barcode.","DATA_MATRIX":"DataMatrix barcode."}},"page":{"description":"The page number on which the barcode was found.","type":"integer"},"value":{"description":"The information of the barcode.","type":"string"}}}},"components/schemas/ListFaxesObject":{"id":"components/schemas/ListFaxesObject","kind":"json-schema","title":"ListFaxesObject","data":{"type":"object","allOf":[{"type":"object","description":"A list of faxes with pagination information.","properties":{"faxes":{"type":"array","description":"An array of faxes","items":{"$ref":"#/components/schemas/Fax"}}}},{"$ref":"#/components/schemas/Pagination"}]}},"components/schemas/CoverPage":{"id":"components/schemas/CoverPage","kind":"json-schema","title":"CoverPage","data":{"description":"A cover page resource","type":"object","required":["file","name"],"properties":{"id":{"type":"string","format":"ulid","readOnly":true,"description":"ID of the cover page"},"name":{"description":"The friendly name of the cover page.","example":"Acme Company cover page"},"file":{"type":"object","required":["fileContent","fileType"],"properties":{"fileContent":{"type":"string","format":"base64","contentEncoding":"base64","description":"A PDF Cover encoded as base64"},"fileType":{"type":"string","enum":["PDF"],"description":"For now only PDF is supported.","x-enumDescriptions":{"PDF":"A PDF file."},"default":"PDF"}},"description":"A PDF Cover encoded as base64"},"projectId":{"allOf":[{"$ref":"#/components/schemas/ProjectId"}],"readOnly":true},"serviceId":{"allOf":[{"$ref":"#/components/schemas/ServiceId"}],"readOnly":true},"createdTime":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the cover page was created."},"updatedTime":{"type":"string","readOnly":true,"format":"date-time","description":"The date and time the cover page was updated."}}}},"components/schemas/Service":{"id":"components/schemas/Service","kind":"json-schema","title":"Service","data":{"type":"object","description":"You can use the default created service, or create multiple services within the same project to have different default behavior for all your different faxing use cases.","properties":{"id":{"$ref":"#/components/schemas/ServiceId"},"name":{"type":"string","description":"A friendly name for the service. Maximum is 60 characters.","example":"Default service","default":"Default service"},"incomingWebhookUrl":{"type":"string","x-version":1,"description":"The URL to which Sinch will post when someone sends a fax to your Sinch number. To accept incoming faxes this must be set and your Sinch phone number must be configured to receive faxes.\n\nNote: If a webhook uses basicauth credentials, when the webhook URL is retrieved those credentials are masked. It is not possible to retrieve previously-set credentials through the API. ","readOnly":false,"example":"https://yourserver/incomingFax"},"webhookContentType":{"description":"The content type of the webhook.","type":"string","default":"multipart/form-data","enum":["multipart/form-data","application/json"],"x-enumDescriptions":{"multipart/form-data":"The webhook will be sent as a multipart/form-data request. Files are sent as attachments to the body.","application/json":"The webhook will be sent as a JSON request. Files are sent as base64 encoded strings in the JSON object."}},"defaultForProject":{"x-version":1,"type":"boolean","format":"string","description":"If set to true this is the service used to create faxes when no serviceId is specified in the API endpoints.","default":false,"x-internal":"When an account and project is created, a default service for Voice should be created, and the test number should be assigned to this service"},"defaultFrom":{"x-version":1,"type":"string","description":"One of your Sinch numbers connected to this service or any of your verified numbers."},"numberOfRetries":{"type":"integer","description":"The number of times to retry sending a fax if it fails. Default is 3. Maximum is 5.","default":3},"retryDelaySeconds":{"description":"The number of seconds to wait between retries if the fax is not yet completed.","type":"integer","minimum":30,"maximum":300,"default":60},"imageConversionMethod":{"$ref":"#/components/schemas/ImageConversionMethod"},"coverPageId":{"type":"string","format":"ulid","description":"If a value it will always add that cover page id to outbound faxes","x-internal":"in ui this will be a select list of the pages on the service"},"saveOutboundFaxDocuments":{"description":"Save fax documents with Sinch when you send faxes. Fax records are retained for 13 months. Records older than 13 months are deleted.","type":"boolean","default":true},"saveInboundFaxDocuments":{"description":"Save fax documents with Sinch when you receive faxes. Fax records are retained for 13 months. Records older than 13 months are deleted.","type":"boolean","default":true},"scanIncomingBarcodes":{"type":"boolean","description":"If set to true, barcodes will be detected on incoming faxes.","default":false},"inProgressNotifications":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you will receive a webhook notification for each page sent on an outbound fax."},"children":[]}]}]}],"default":false},"projectId":{"$ref":"#/components/schemas/ProjectId","readOnly":true},"resolution":{"$ref":"#/components/schemas/Resolution"},"createdAt":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the service was created."},"updatedAt":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the service was last updated."}}}},"components/schemas/ImageConversionMethod":{"id":"components/schemas/ImageConversionMethod","kind":"json-schema","title":"ImageConversionMethod","data":{"type":"string","description":"Determines how documents are converted to black and white on OUTBOUND faxes only. Image conversion is not done on INBOUND faxes. Defaults to value selected on Fax Service object.","enum":["HALFTONE","MONOCHROME"],"x-enumDescriptions":{"HALFTONE":"Converts the image to halftone.","MONOCHROME":"Converts the image to monochrome."},"default":"HALFTONE"}},"components/schemas/ServicePhoneNumber":{"id":"components/schemas/ServicePhoneNumber","kind":"json-schema","title":"ServicePhoneNumber","data":{"type":"object","properties":{"phoneNumber":{"$ref":"#/components/schemas/PhoneNumber"},"permissions":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"both"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"x-enumDescriptions":{"both":"Allows the email to send and receive faxes to this email/phone number combination.","send":"Allows the email to only send faxes to this email/phone number combination.","receive":"Allows the email to only receive faxes from this email/phone number combination."},"enum":["both","send","receive"],"default":"both"},"country":{"readOnly":true,"type":"string","description":"The country code of the phone number in ISO 3166-1 alpha-2 format.","example":"US"},"suspended":{"type":"boolean","description":"Specifies if a number is suspended or not.","example":true,"readOnly":true},"note":{"type":"string","description":"An optional field providing context about the suspension.","example":"Reason for suspending the number.","readOnly":true},"projectId":{"$ref":"#/components/schemas/ProjectId","readOnly":true},"serviceId":{"$ref":"#/components/schemas/ServiceId","readOnly":true}}}},"components/schemas/SuspendRequest":{"id":"components/schemas/SuspendRequest","kind":"json-schema","title":"SuspendRequest","data":{"type":"object","description":"The request body for suspending a number.","properties":{"suspended":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to suspend a number."},"children":[]}]}]}],"example":true},"note":{"type":"string","description":"An optional field to include a note providing context about the suspension.","example":"Reason for suspending the number."}}}},"components/schemas/FaxId":{"id":"components/schemas/FaxId","kind":"json-schema","title":"FaxId","data":{"type":"string","readOnly":true,"description":"The id of a fax","example":"01F3J0G1M4WQR6HGY6HCF6JA0K"}},"components/schemas/WebhookEvents":{"id":"components/schemas/WebhookEvents","kind":"json-schema","title":"WebhookEvents","data":{"type":"string","enum":["INCOMING_FAX","FAX_COMPLETED"],"x-enumDescriptions":{"INCOMING_FAX":"A webhook event triggered by an fax is incoming.","FAX_COMPLETED":"A webhook event triggered by a fax that has successfully completed."},"description":"The different events that can trigger a webhook"}},"components/schemas/GenericEvent":{"id":"components/schemas/GenericEvent","kind":"json-schema","title":"GenericEvent","data":{"type":"object","properties":{"event":{"$ref":"#/components/schemas/WebhookEvents"},"eventTime":{"description":"Time of the event.","type":"string","format":"date-time"},"fax":{"$ref":"#/components/schemas/Fax"}}}},"components/schemas/ServiceId":{"id":"components/schemas/ServiceId","kind":"json-schema","title":"ServiceId","data":{"x-PII":false,"x-v1":true,"readOnly":true,"type":"string","example":"01GVRB50KEQFFE1SGMPFRNBG6J","description":"ID of the fax service used."}},"components/schemas/FaxStatus":{"id":"components/schemas/FaxStatus","kind":"json-schema","title":"FaxStatus","data":{"type":"string","description":"The status of the fax","readOnly":true,"enum":["QUEUED","IN_PROGRESS","COMPLETED","FAILURE"],"x-enumDescriptions":{"QUEUED":"The operation is currently in a queue on a server and should be executed very soon.","IN_PROGRESS":"The fax is currently being sent (OUTBOUND) or received (INBOUND).","COMPLETED":"The fax operation succeeded. Everything went as normally planned.","FAILURE":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fax operation failed. Details of the error can be found in the error_code field. For OUTBOUND fax, this means that NONE of the recipients received the fax."},"children":[]}]}]}]}}},"components/schemas/CoverPageData":{"id":"components/schemas/CoverPageData","kind":"json-schema","title":"Cover page data","data":{"type":"object","title":"Cover page data","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can use this to specify custom data for your cover page that will be sent as part of the fax. It is a key value store. Read more about how to use this "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developers.sinch.com/docs/fax/api-reference/fax/cover-pages/"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". All keys used must be lower case."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"coverPageData\": {\"customfield1\":\"customdata1\"}"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"coverPageData[customfield1] = customdata1"},"children":[]}]}]}]}],"additionalProperties":{"type":"string","x-additionalPropertiesName":"coverPageKey"},"example":{"toName":"Acme Corp"}}},"components/schemas/Labels":{"id":"components/schemas/Labels","kind":"json-schema","title":"label","data":{"type":"object","title":"label","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can use this to attach labels to your call that you can use in your applications. It is a key value store."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"labels\": {\"label1\":\"value1\"}"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"labels[label1] = value1"},"children":[]}]}]}]}],"additionalProperties":{"type":"string","x-additionalPropertiesName":"labelKey"},"example":{"use-case":"fraudPrevention","costCenter":"sales"}}},"components/schemas/PhoneNumber":{"id":"components/schemas/PhoneNumber","kind":"json-schema","title":"PhoneNumber","data":{"x-PII":true,"x-v1":true,"type":"string","format":"phoneNumber","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A phone number in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://community.sinch.com/t5/Glossary/E-164/ta-p/7537"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"E.164"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format, including the leading '+'."},"children":[]}]}]}],"example":"+15551235656"}},"components/schemas/PhoneNumberArray":{"id":"components/schemas/PhoneNumberArray","kind":"json-schema","title":"PhoneNumberArray","data":{"description":"An array of phone numbers to send multiple faxes.","type":"array","items":{"$ref":"#/components/schemas/PhoneNumber"}}},"components/schemas/ProjectId":{"id":"components/schemas/ProjectId","kind":"json-schema","title":"ProjectId","data":{"type":"string","x-PII":false,"x-v1":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the project associated with the call."},"children":[]}]}]}],"x-Internal":"to support future account keys","readOnly":true,"example":"ae00f005-e392-44dc-b3f5-a657a2684dg3"}},"components/schemas/Money":{"id":"components/schemas/Money","kind":"json-schema","title":"Money","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is where we need description to be overridden by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"$ref:"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" description"},"children":[]}]}]}],"type":"object","readOnly":true,"properties":{"currencyCode":{"readOnly":true,"description":"The 3-letter currency code defined in ISO 4217.","type":"string","example":"USD"},"amount":{"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount with 4 decimals and decimal delimiter "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","example":"0.0040"}}}},"components/schemas/Resolution":{"id":"components/schemas/Resolution","kind":"json-schema","title":"Resolution","data":{"type":"string","description":"The resolution for the fax. If this is set at the service, this applies to all faxes sent using that service. If this is set on the fax, this will override the service setting.","enum":["FINE","SUPERFINE"],"x-enumDescriptions":{"FINE":"Most commonly accepted fax resolution at 200 dpi.","SUPERFINE":"Higher but less commonly accepted fax resolution at 400 dpi. May be required when sending small text or detailed images."}}},"components/schemas/Pagination":{"id":"components/schemas/Pagination","kind":"json-schema","title":"Pagination","data":{"type":"object","readOnly":true,"properties":{"page":{"readOnly":true,"type":"integer","description":"Current page"},"totalPages":{"readOnly":true,"type":"integer","description":"Total number of pages."},"pageSize":{"readOnly":true,"type":"integer","description":"Number of items per page."},"totalItems":{"type":"integer","readOnly":true,"format":"int32","description":"Total size of the result."}}}},"components/schemas/CreateDomainResponse":{"id":"components/schemas/CreateDomainResponse","kind":"json-schema","title":"CreateDomainResponse","data":{"type":"object","properties":{"result":{"type":"string","description":"The result of the create domain operation.","example":"domain and route created"},"records":{"type":"object","properties":{"receivingRecords":{"type":"array","description":"The receiving records of the domain.","items":{"$ref":"#/components/schemas/ReceivingRecords"}},"sendingRecords":{"type":"array","description":"The sending records of the domain.","items":{"$ref":"#/components/schemas/SendingRecords"}}}}}}},"components/schemas/ReceivingRecords":{"id":"components/schemas/ReceivingRecords","kind":"json-schema","title":"ReceivingRecords","data":{"type":"object","properties":{"isActive":{"type":"boolean","description":"True if the domain is active."},"cached":{"type":"array","description":"Any cached value of the record.","items":{"type":"string"}},"priority":{"type":"integer","description":"The priority for the record.","example":10},"recordType":{"type":"string","description":"The type of the record.","example":"TXT"},"valid":{"type":"string","description":"The validity of the record.","enum":["valid","invalid"],"x-enumDescriptions":{"valid":"The record is valid.","invalid":"The record is invalid."},"example":"valid"},"value":{"type":"string","description":"The value of the record.","example":"mailgun.org"}}}},"components/schemas/SendingRecords":{"id":"components/schemas/SendingRecords","kind":"json-schema","title":"SendingRecords","data":{"type":"object","properties":{"isActive":{"type":"boolean","description":"True if the domain is active."},"cached":{"type":"array","description":"Any cached value of the record.","items":{"type":"string"}},"name":{"type":"string","description":"The name of the domain record.","example":"my.domain.com"},"recordType":{"type":"string","description":"The type of the record.","example":"TXT"},"valid":{"type":"string","description":"The validity of the record.","enum":["valid","invalid"],"x-enumDescriptions":{"valid":"The record is valid.","invalid":"The record is invalid."},"example":"valid"},"value":{"type":"string","description":"The value of the record.","example":"mailgun.org"}}}},"components/schemas/DomainsListResponse":{"id":"components/schemas/DomainsListResponse","kind":"json-schema","title":"DomainsListResponse","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/Pagination"},{"type":"object","properties":{"domains":{"type":"array","items":{"$ref":"#/components/schemas/Domain"}}}}]}},"components/schemas/Domain":{"id":"components/schemas/Domain","kind":"json-schema","title":"Domain","data":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the domain.","example":"01K8BS9391KGN2Y36CDSNAVHNW"},"name":{"type":"string","description":"The name of the domain.","example":"my.domain.com"},"receivingDnsRecord":{"$ref":"#/components/schemas/ReceivingRecords"},"sendingDnsRecord":{"$ref":"#/components/schemas/SendingRecords"},"serviceId":{"type":"string","description":"The ID of the service to which the domain is attached.","example":"01H66TG3G97XH3GGVYP1NF7CYT"},"createdAt":{"type":"string","description":"The timestamp on which the domain was created.","format":"date-time","example":"2025-10-24 18:56:42.787000+00:00"},"updatedAt":{"type":"string","description":"The timestamp on which the domain was updated.","format":"date-time","example":"2025-10-24 19:11:50.235000+00:00"},"verified":{"type":"boolean","description":"Flag that shows if the domain has been verified.","example":true},"routeId":{"type":"string","description":"The route ID of the domain.","example":"68fbcbeb0a12858e880ffcea"}}}},"components/schemas/DomainDetails":{"id":"components/schemas/DomainDetails","kind":"json-schema","title":"DomainDetails","data":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the domain.","example":"01K8BS9391KGN2Y36CDSNAVHNW"},"isDisabled":{"type":"boolean","description":"Flag that shows if the domain is disabled.","example":false},"name":{"type":"string","description":"The name of the domain.","example":"my.domain.com"},"requireTls":{"type":"boolean","description":"If set to true, this requires messages for the domain only be sent over a TLS connection. If a TLS connection cannot be established, Mailgun will not deliver the message. If set to false, Mailgun will still try and upgrade the connection, but if Mailgun cannot, the message will be delivered over a plaintext SMTP connection.","example":false,"default":false},"skipVerification":{"type":"boolean","description":"If set to true, the certificate and hostname will not be verified when trying to establish a TLS connection and Mailgun will accept any certificate during delivery of a message. If set to false, Mailgun will verify the certificate and hostname. If either one can not be verified, a TLS connection will not be established.","example":false,"default":false},"smtpLogin":{"type":"string","description":"SMTP server password for authentication.","example":""},"spamAction":{"type":"string","description":"Disabled, block or tag. Default to disabled. If disabled, no spam filtering will occur for inbound messages.","enum":["disabled","block","tag"],"x-enumDescriptions":{"disabled":"No spam filtering will occur for inbound messages.","block":"Inbound spam messages will not be delivered.","tag":"Inbound messages will be tagged with a spam header."},"example":"disabled","default":"disabled"},"state":{"type":"string","description":"The current verification status of the domain.","example":"active"},"type":{"type":"string","description":"The classification of the domain.","enum":["custom","sandbox"],"x-enumDescriptions":{"custom":"Domain is of custom type.","sandbox":"Domain is of sandbox type."},"example":"custom"},"useAutomaticSenderSecurity":{"type":"boolean","description":"Enable Automatic Sender Security. This requires setting DNS CNAME entries for DKIM keys instead of a TXT record.","example":false,"default":false},"webPrefix":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets your open, click and unsubscribe URLs domain name prefix. Links rewritten or added by Mailgun in your emails will look like ://./..."},"children":[]}]}]}],"example":"email","default":"email"},"webScheme":{"type":"string","enum":["http","https"],"x-enumDescriptions":{"http":"Use http when opening URLs.","https":"Use https when opening URLs."},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets your open, click and unsubscribe URLs to use http or https. Value either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". In order for https to work, you must have a valid cert created for your domain."},"children":[]}]}]}],"example":"http","default":"http"},"wildcard":{"type":"boolean","description":"Allows domain to accept inbound messages received on subdomains that have MX records pointed to Mailgun.","example":false,"default":false},"encryptIncomingMessage":{"type":"boolean","description":"Enable encrypting incoming messages for the given domain. This cannot be altered via API after being set for security purposes. Reach out to Support to disable if necessary.","example":false,"default":false},"messageTtl":{"type":"integer","description":"Specifies the time-to-live (TTL) in seconds for retrieving both incoming and outgoing messages. The maximum TTL value is determined by your subscription plan.","example":259200}}}},"components/schemas/DomainDetailsResponse":{"id":"components/schemas/DomainDetailsResponse","kind":"json-schema","title":"DomainDetailsResponse","data":{"type":"object","properties":{"domain":{"$ref":"#/components/schemas/DomainDetails"},"receivingDnsRecords":{"type":"array","description":"The receiving records of the domain.","items":{"$ref":"#/components/schemas/ReceivingRecords"}},"sendingDnsRecords":{"type":"array","description":"The sending records of the domain.","items":{"$ref":"#/components/schemas/SendingRecords"}}}}},"components/schemas/VerifyDomainResponse":{"id":"components/schemas/VerifyDomainResponse","kind":"json-schema","title":"VerifyDomainResponse","data":{"type":"object","properties":{"domains":{"type":"array","items":{"$ref":"#/components/schemas/VerifyDomainObject"}}}}},"components/schemas/VerifyDomainDetails":{"id":"components/schemas/VerifyDomainDetails","kind":"json-schema","title":"VerifyDomainDetails","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/DomainDetails"}],"properties":{"serviceId":{"type":"string","description":"The service ID to which the domain is assigned.","example":"01H66TG3G97XH3GGVYP1NF7CYD"},"projectId":{"type":"string","description":"The project ID to which the domain is assigned.","example":"5ff51b4c-7e9f-4acc-9f0e-6dd9559722e6"}}}},"components/schemas/VerifyDomainObject":{"id":"components/schemas/VerifyDomainObject","kind":"json-schema","title":"VerifyDomainObject","data":{"type":"object","properties":{"message":{"type":"string","description":"This message describes what is updated.","example":"Domain DNS records have been updated"},"domain":{"$ref":"#/components/schemas/VerifyDomainDetails"},"receivingDnsRecords":{"type":"array","description":"The receiving records of the domain.","items":{"$ref":"#/components/schemas/ReceivingRecords"}},"sendingDnsRecords":{"type":"array","description":"The sending records of the domain.","items":{"$ref":"#/components/schemas/SendingRecords"}}}}},"components/schemas/TemplatesDomainNameResponse":{"id":"components/schemas/TemplatesDomainNameResponse","kind":"json-schema","title":"TemplatesDomainNameResponse","data":{"type":"array","description":"An array of the named templates for the domain specified.","items":{"$ref":"#/components/schemas/TemplateDomainItem"}}},"components/schemas/TemplateDomainItem":{"id":"components/schemas/TemplateDomainItem","kind":"json-schema","title":"TemplateDomainItem","data":{"type":"object","description":"The named templates.","properties":{"name":{"$ref":"#/components/schemas/TemplateName"},"createdAt":{"type":"string","description":"The timestamp on which the template was created.","format":"date-time","example":"2025-10-24 19:11:50.235000+00:00"},"description":{"type":"string","description":"The description for the template.","example":"Successful fax template"}}}},"components/schemas/UpdateTemplateRequest":{"id":"components/schemas/UpdateTemplateRequest","kind":"json-schema","title":"UpdateTemplateRequest","data":{"type":"object","properties":{"template":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The contents of the template. The following variables are available for you to use in templates:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Variable"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The phone number sending the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The phone number receiving the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"completedTime"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date and time that the fax was completed."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"numberOfPages"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of pages included in the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"currencyCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the fax was billed."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"amount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total cost of the fax."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"retryCount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of times the fax was retried."},"children":[]}]}]}]}]}]}],"example":"

Hi,

You have sent a successful fax to: {{to}}!

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Completed at:{{completedTime}}
Price:{{currencyCode}} {{amount}}

Thanks!

"}}}},"components/schemas/TemplateByNameResponse":{"id":"components/schemas/TemplateByNameResponse","kind":"json-schema","title":"TemplateByNameResponse","data":{"type":"object","properties":{"template":{"type":"object","description":"The email template.","properties":{"name":{"$ref":"#/components/schemas/TemplateName"},"createdAt":{"type":"string","description":"The timestamp on which the template was created.","format":"date-time","example":"2025-10-24 19:11:50.235000+00:00"},"id":{"type":"string","description":"The ID of the template.","example":"8836986f-050c-4b2d-afb9-8069d1520b17"},"version":{"type":"object","properties":{"tag":{"type":"string","description":"The tag for the template.","example":"initial"},"template":{"type":"string","description":"The contents of the template.","example":"

Hi,

You have sent a successful fax to: {{to}}!

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Completed at:{{completedTime}}
Price:{{currencyCode}} {{amount}}

Thanks!

"},"createdAt":{"type":"string","description":"The timestamp on which the template was created.","format":"date-time","example":"2025-10-24 19:11:50.235000+00:00"},"comment":{"type":"string","description":"Optional field for comments if necessary.","example":""},"active":{"type":"boolean","description":"Displays whether the template is active or not.","example":true},"id":{"type":"string","description":"The ID for the template version.","example":"fa01442c-e3d5-482b-be67-e3fdda931b00"},"headers":{"type":"object","description":"Headers that are sent along with the template."}}}}}}}},"components/schemas/Error":{"id":"components/schemas/Error","kind":"json-schema","title":"Error","data":{"type":"object","properties":{"code":{"description":"HTTP status code or error code","readOnly":true,"type":"integer","format":"int32","example":400},"status":{"description":"Response status name.","readOnly":true,"type":"string","example":"INVALID_ARGUMENT"},"message":{"type":"string","readOnly":true,"description":"A developer-facing error message","example":"Bad request."},"details":{"readOnly":true,"description":"Details of the errors","type":"array","items":{"type":"object","allOf":[{"$ref":"#/components/schemas/ErrorDetail"}]}}}}},"components/schemas/ErrorDetail":{"id":"components/schemas/ErrorDetail","kind":"json-schema","title":"ErrorDetail","data":{"type":"object","anyOf":[{"$ref":"#/components/schemas/NotFoundDetail"},{"$ref":"#/components/schemas/BadRequestDetail"},{"$ref":"#/components/schemas/ErrorInfo"}],"discriminator":{"propertyName":"type","mapping":{"NotFound":"#/components/schemas/NotFoundDetail","BadRequest":"#/components/schemas/BadRequestDetail","ErrorInfo":"#/components/schemas/ErrorInfo"}}}},"components/schemas/ErrorType":{"id":"components/schemas/ErrorType","kind":"json-schema","title":"ErrorType","data":{"readOnly":true,"description":"Error type","type":"string","enum":["DOCUMENT_CONVERSION_ERROR","CALL_ERROR","FAX_ERROR","FATAL_ERROR","GENERAL_ERROR"],"x-enumDescriptions":{"DOCUMENT_CONVERSION_ERROR":"A documentation conversion error.","CALL_ERROR":"A call error.","FAX_ERROR":"A fax error.","FATAL_ERROR":"A fatal error.","GENERAL_ERROR":"A general error."}}},"components/schemas/FaxErrors":{"id":"components/schemas/FaxErrors","kind":"json-schema","title":"FaxErrors","data":{"type":"object","anyOf":[{"$ref":"#/components/schemas/DocumentConversionError"},{"$ref":"#/components/schemas/CallError"},{"$ref":"#/components/schemas/FaxError"}],"discriminator":{"propertyName":"errorType","mapping":{"DOCUMENT_CONVERSION_ERROR":"#/components/schemas/DocumentConversionError","CALL_ERROR":"#/components/schemas/CallError","FAX_ERROR":"#/components/schemas/FaxError"}},"examples":[{"DocumentConversionError":null,"summary":"Document conversion error","value":{"errorType":"DOCUMENT_CONVERSION_ERROR","errorMessage":"There was a problem in converting and merging files to the output file format. Contact support.","errorCode":4}},{"CallError":null,"summary":"Call error","value":{"errorType":"CALL_ERROR","errorMessage":"Busy","errorCode":17}},{"FaxError":null,"summary":"Fax error","value":{"errorType":"FAX_ERROR","errorMessage":"Could not establish a connection to the fax server.","errorCode":6}}]}},"components/schemas/FaxError":{"id":"components/schemas/FaxError","kind":"json-schema","title":"FaxError","data":{"type":"object","description":"A problem occurred during the fax communication process.","properties":{"errorType":{"description":"Type of error for the fax","type":"string","enum":["FAX_ERROR"],"x-enumDescriptions":{"FAX_ERROR":"An error related to the fax."},"example":"FAX_ERROR"},"errorMessage":{"description":"A developer-facing error message","type":"string","example":"Could not establish a connection to the fax server."},"errorCode":{"type":"integer","description":"The error code returned describing the error of the call","enum":[6,7,8,10,12,13,14,18,20,21,22,25,26,28,29,31,38,40,41,44,46,48,53,60,63,68,75,76,77,79,80,82,84,113,117,119,131,132,133],"x-enumDescriptions":{"6":"There was an error communicating with the far side.","7":"Far end cannot receive at the size of image","8":"No response after sending a page","10":"Disconnected after permitted retries","12":"Received no response to DCS or TCF","13":"Timed out waiting for the first message","14":"Timed out waiting for initial communication","18":"Unexpected message received","20":"The HDLC carrier did not stop in a timely manner","21":"Received a DCN from remote after sending a page","22":"Received bad response to DCS or training","25":"Far end cannot receive at the resolution of the image","26":"The remote fax machine failed to respond","28":"Failed to train with any of the compatible modems","29":"Invalid response after sending a page","31":"Fax machine incompatibility","38":"The remote fax machine hung up before receiving fax","40":"Telephony error","41":"Unexpected DCN while waiting for DCS or DIS","44":"Telephony Error","46":"Insufficient funds to send fax and not able to auto recharge; There was a problem charging your credit card. Please check your payment information and try again.","48":"No answer (The Receiving Machine May Be Out Of Paper)","53":"Unexpected DCN after EOM or MPS sequence","60":"Transmission error after page break","63":"Fax protocol error","68":"Far end is not compatible","75":"Manually canceled by user","76":"Canceled automatically because timeout exceeded","77":"Timed out waiting for receiver ready (ECM mode)","79":"Can't cancel the fax, it's already complete!","80":"Received a DCN while waiting for a DIS","82":"There was an error communicating with the far side","84":"Unexpected command after page received","113":"The file for this fax has been deleted or is not accessible.","117":"No pages received","119":"User requested simulated faxError","131":"Incomplete transmission","132":"No fax tone detected","133":"Phone number is not permitted"}}}}},"components/schemas/CallError":{"id":"components/schemas/CallError","kind":"json-schema","title":"CallError","data":{"type":"object","description":"There was a problem with the phone line. The call could not be placed. Many times you can just try again","properties":{"errorType":{"description":"Type of error for the Call","type":"string","enum":["CALL_ERROR"],"x-enumDescriptions":{"CALL_ERROR":"An error related to the call."},"example":"CALL_ERROR"},"errorMessage":{"description":"A developer-facing error message","type":"string","example":"Busy"},"errorCode":{"type":"integer","description":"The error code returned describing the error of the call.","enum":[11,15,16,17,19,30,32,34,43,49],"x-enumDescriptions":{"11":"The call dropped prematurely","15":"Congestion","16":"Ring Timeout","17":"Busy","19":"Immediate Hangup","30":"No answer from a fax machine.","32":"Incompatible destination","34":"Phone number not operational","43":"Problem establishing connection","49":"The destination phone number Is Not active"}}}}},"components/schemas/DocumentConversionError":{"id":"components/schemas/DocumentConversionError","kind":"json-schema","title":"DocumentConversionError","data":{"type":"object","description":"Conversion errors usually occur when there is a problem with one of the files you posted.","properties":{"errorType":{"description":"Type of error for the Document conversion","type":"string","enum":["DOCUMENT_CONVERSION_ERROR"],"x-enumDescriptions":{"DOCUMENT_CONVERSION_ERROR":"An error related to document conversion."},"example":"DOCUMENT_CONVERSION_ERROR"},"errorMessage":{"description":"The error message","type":"string","example":"There was a problem in converting and merging files to the output file format. Contact support."},"errorCode":{"type":"integer","description":"The error code returned during document conversion.","enum":[4,54,55,57,69,122,128,129,130,133],"x-enumDescriptions":{"4":"There was a problem in converting and merging files to the output file format. Contact support.","54":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Could not access the url you provided. {contentUrl}"},"children":[]}]}]}],"55":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The string_data URL you provided is invalid"},"children":[]}]}]}],"57":"There was a problem storing the file you provided.","69":"There was a problem storing the file you provided.","122":"User simulated Document Conversion Error","128":"Could not determine mimetype for file.","129":"Mimetype not supported.","130":"Mimetype not supported: application/xml","133":"Failed to normalize PDF document"}}}}},"components/schemas/NotFoundDetail":{"id":"components/schemas/NotFoundDetail","kind":"json-schema","title":"NotFoundDetail","data":{"type":"object","description":"The request was malformed on one or more fields.","x-internal":"https://github.com/googleapis/googleapis/blob/f79d6e85a9a6b913a5e9cb0067e846e7f087dbc8/google/rpc/error_details.proto#L169","properties":{"type":{"type":"string","description":"The request was malformed on one or more properties.","readOnly":true,"example":"NOT_FOUND","default":"BadRequest"}}}},"components/schemas/BadRequestDetail":{"id":"components/schemas/BadRequestDetail","kind":"json-schema","title":"BadRequestDetail","data":{"type":"object","description":"The request was malformed on one or more fields.","x-internal":"https://github.com/googleapis/googleapis/blob/f79d6e85a9a6b913a5e9cb0067e846e7f087dbc8/google/rpc/error_details.proto#L169","properties":{"type":{"type":"string","description":"The request was malformed on one or more properties.","readOnly":true,"example":"BadRequest","default":"BadRequest"},"fieldViolations":{"description":"The field violation(s).","type":"array","items":{"type":"object","readOnly":true,"allOf":[{"$ref":"#/components/schemas/FieldViolation"}]},"example":[{"field":"to","description":"Phone number was not in the expected format."}]}}}},"components/schemas/FieldViolation":{"id":"components/schemas/FieldViolation","kind":"json-schema","title":"FieldViolation","data":{"type":"object","properties":{"field":{"type":"string","readOnly":true,"description":"Request field.","example":"to"},"description":{"type":"string","readOnly":true,"description":"Description of why the request field was considered invalid.","example":"Phone number was not in the expected format."}}}},"components/schemas/ErrorInfo":{"id":"components/schemas/ErrorInfo","kind":"json-schema","title":"ErrorInfo","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Describes the cause of the error with structured details."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example of an error when trying to make a call to blocked destination:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{ \"reason\": \"DESTINATION_BLOCKED\""},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"domain\": \"VOICE\""},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"metadata\": {"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"country\": \"Bermuda\","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"}"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"}"},"children":[]}]}]}],"type":"object","properties":{"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Describes the cause of the error with structured details."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example of an error when trying to make a call to blocked destination:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":" { \"reason\": \"DESTINATION_BLOCKED\"\n \"domain\": \"VOICE\"\n \"metadata\": {\n \"country\": \"Bermuda\",\n }\n }\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":" { \"reason\": \"DESTINATION_BLOCKED\"\n \"domain\": \"VOICE\"\n \"metadata\": {\n \"country\": \"Bermuda\",\n }\n }\n"},"children":[]}]}],"default":"ErrorInfo","example":"ErrorInfo"},"reason":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reason of the error. This is a constant value that identifies the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"proximate cause of the error. Error reasons are unique. Max 63 characters and match"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/[A-Z0-9_]+/."},"children":[]}]}]}],"maxLength":63},"domain":{"type":"string","description":"Domain for error, for voice its always sinch.voice"},"metaData":{"description":"Additional structured details about this error. key value pair of strings","type":"object"}}}},"schema_638":{"kind":"json-schema","data":{"type":"string","example":"3acb7ae1-cf3d-4112-ba5e-3a9d8c71cd47"},"id":"schema_638"},"schema_639":{"kind":"json-schema","data":{"required":["to"],"allOf":[{"type":"object","properties":{"to":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you send a fax you can specify a single number or a list of numbers separated by commas (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+12345550100,+12345550101"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note that if you specify a list of numbers, the fax will be sent to all numbers and a Fax resource will be created for each number."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you receive a fax, this is the number where the fax is sent to."},"children":[]}]}]}],"$ref":"#/components/schemas/PhoneNumber"},"file":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The file(s) you want to send as a fax as body attachment. You made use any of the following file types:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".docx"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".html"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".jpg"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".png"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".tif"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".pdf"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".txt"},"children":[]}]}]}]}],"type":"string","format":"binary"}}},{"$ref":"#/components/schemas/Fax"}]},"id":"schema_639"},"schema_640":{"kind":"json-schema","data":{"required":["to"],"allOf":[{"type":"object","properties":{"to":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you send a fax you can specify a single number, a list of numbers separated by by commas (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+12345550100,+12345550101"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), or an array of phone numbers."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note that if you specify a list of numbers, the fax will be sent to all numbers and a Fax resource will be created for each number."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you receive a fax, this is the number where the fax is sent to."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/PhoneNumber"},{"$ref":"#/components/schemas/PhoneNumberArray"}]},"from":{"$ref":"#/components/schemas/PhoneNumber","description":"The number you want to send a fax from. This number must be associated with your account.\nIf you do not specify a from number, we will use the first number associated with your account."}}},{"$ref":"#/components/schemas/FaxBase64Array"},{"$ref":"#/components/schemas/Fax"}]},"id":"schema_640"},"schema_641":{"kind":"json-schema","data":{"type":"string","example":"YOUR_SERVICE_ID"},"id":"schema_641"},"schema_642":{"kind":"json-schema","data":{"type":"string","format":"date-time"},"id":"schema_642"},"schema_643":{"kind":"json-schema","data":{"$ref":"#/components/schemas/FaxDirection"},"id":"schema_643"},"schema_644":{"kind":"json-schema","data":{"$ref":"#/components/schemas/FaxStatus"},"id":"schema_644"},"schema_645":{"kind":"json-schema","data":{"$ref":"#/components/schemas/PhoneNumber"},"id":"schema_645"},"schema_646":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Labels"},"id":"schema_646"},"schema_647":{"kind":"json-schema","data":{"type":"string","enum":["csv"],"x-enumDescriptions":{"csv":"This exports the list of faxes as a .csv file."},"example":"csv"},"id":"schema_647"},"schema_648":{"kind":"json-schema","data":{"type":"integer","maximum":1000,"minimum":1},"id":"schema_648"},"schema_649":{"kind":"json-schema","data":{"type":"string"},"id":"schema_649"},"schema_650":{"kind":"json-schema","data":{"type":"string","example":"US"},"id":"schema_650"},"schema_651":{"kind":"json-schema","data":{},"id":"schema_651"},"schema_652":{"kind":"json-schema","data":{"$ref":"#/components/schemas/FaxId"},"id":"schema_652"},"schema_653":{"kind":"json-schema","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A PDF file named 'fax-1234.pdf' containing all files sent for fax #1234."},"children":[]}]}]}],"type":"string","format":"binary"},"id":"schema_653"},"schema_654":{"kind":"json-schema","data":{"type":"string","enum":["pdf"],"default":"pdf","x-enumDescriptions":{"pdf":"PDF format"}},"id":"schema_654"},"schema_655":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"event":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The value is always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INCOMING_FAX"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this event."},"children":[]}]}]}],"enum":["INCOMING_FAX"],"default":"INCOMING_FAX"},"file":{"$ref":"#/components/schemas/FileTypeMultiPart"}}},{"$ref":"#/components/schemas/GenericEvent"}]},"id":"schema_655"},"schema_656":{"kind":"json-schema","data":{"type":"object","properties":{"event":{"allOf":[{"$ref":"#/components/schemas/WebhookEvents"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INCOMING_FAX"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this event."},"children":[]}]}]}],"enum":["INCOMING_FAX"],"default":"INCOMING_FAX"},"eventTime":{"description":"Time of the event.","type":"string","format":"date-time"},"fax":{"description":"The incoming fax.","$ref":"#/components/schemas/Fax"},"file":{"description":"The base64 encoded file.","type":"string","example":"{base64_encodedData}"},"fileType":{"$ref":"#/components/schemas/FileTypeJson"}}},"id":"schema_656"},"schema_657":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"event":{"type":"string","description":"Always fax completed for this event.","enum":["FAX_COMPLETED"],"default":"FAX_COMPLETED"},"file":{"description":"The fax content as pdf attachment to the body","type":"string","format":"binary","contentMediaType":"application/pdf","contentEncoding":"binary"}}},{"$ref":"#/components/schemas/GenericEvent"}]},"id":"schema_657"},"schema_658":{"kind":"json-schema","data":{"type":"object","properties":{"event":{"allOf":[{"$ref":"#/components/schemas/WebhookEvents"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FAX_COMPLETED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this event."},"children":[]}]}]}],"enum":["FAX_COMPLETED"],"default":"FAX_COMPLETED"},"eventTime":{"description":"Time of the event.","type":"string","format":"date-time"},"fax":{"description":"The incoming fax.","$ref":"#/components/schemas/Fax"},"files":{"type":"array","items":{"$ref":"#/components/schemas/FaxBase64File"}}}},"id":"schema_658"},"schema_659":{"kind":"json-schema","data":{"type":"string","description":"A phone number in e.164 format.","example":"+15612600684"},"id":"schema_659"},"schema_660":{"kind":"json-schema","data":{"type":"integer","default":1,"example":1},"id":"schema_660"},"schema_661":{"kind":"json-schema","data":{"type":"integer","default":100,"example":20,"maximum":1000},"id":"schema_661"},"schema_662":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"emails":{"description":"List of emails numbers","type":"array","items":{"type":"string","format":"email"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_662"},"schema_663":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"emails":{"description":"List of emails","type":"array","items":{"$ref":"#/components/schemas/Email"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_663"},"schema_664":{"kind":"json-schema","data":{"type":"object","required":["phoneNumbers"],"properties":{"phoneNumbers":{"description":"List of numbers","type":"array","items":{"$ref":"#/components/schemas/Number"}}}},"id":"schema_664"},"schema_665":{"kind":"json-schema","data":{"type":"integer","default":20,"example":20,"maximum":1000},"id":"schema_665"},"schema_666":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"phoneNumbers":{"description":"List of numbers","type":"array","items":{"$ref":"#/components/schemas/ServicePhoneNumber"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_666"},"schema_667":{"kind":"json-schema","data":{"type":"string","example":"01GVRB50KEQFFE1SGMPFRNBG6J"},"id":"schema_667"},"schema_668":{"kind":"json-schema","data":{"type":"string","example":"yourdomain.com"},"id":"schema_668"},"schema_669":{"kind":"json-schema","data":{"$ref":"#/components/schemas/TemplateName"},"id":"schema_669"},"schema_670":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"coverPages":{"description":"List of cover pages","type":"array","items":{"$ref":"#/components/schemas/CoverPage"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_670"},"schema_671":{"kind":"json-schema","data":{"type":"string","description":"The coverPageId you want to work with."},"id":"schema_671"},"schema_672":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"services":{"description":"List of services.","type":"array","items":{"$ref":"#/components/schemas/Service"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_672"},"schema_673":{"kind":"json-schema","data":{"allOf":[{"type":"object","properties":{"numbers":{"description":"List of phone numbers","type":"array","items":{"$ref":"#/components/schemas/ServicePhoneNumber"}}}},{"$ref":"#/components/schemas/Pagination"}]},"id":"schema_673"}},"exampleStore":{"components/examples/SendWebPageAsFax":{"id":"components/examples/SendWebPageAsFax","value":{"to":"+14155552222","contentUrl":"https://developers.sinch.com/fax/fax.pdf"},"summary":"Send a web page as a fax"},"components/examples/SendFileAsFax":{"id":"components/examples/SendFileAsFax","value":{"to":"+14155552222","file":"//path/to/file.pdf"},"summary":"Send a file as a fax"},"components/examples/SendFileAsFaxWithCoverPage":{"id":"components/examples/SendFileAsFaxWithCoverPage","value":{"to":"+14155552222","file":"//path/to/file.pdf","coverPageId":"12312kj312kl3j12k3j","coverPageData":{"message":"To Dr. Smith regarding referral"}},"summary":"Send a fax with cover page"},"components/examples/SendFileAsFaxJson":{"id":"components/examples/SendFileAsFaxJson","value":{"to":["+14155552222","+14155552233"],"files":[{"file":"{base64EncodedData}","fileType":"PDF"}]},"summary":"Send a file as a fax"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax":{"value":{"to":"+14155552222","contentUrl":"https://developers.sinch.com/fax/fax.pdf"},"key":"SendFax","summary":"Send a web page as a fax","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFax"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage":{"value":{"to":"+14155552222","file":"//path/to/file.pdf","coverPageId":"12312kj312kl3j12k3j","coverPageData":{"message":"To Dr. Smith regarding referral"}},"key":"SendFileAsFaxWithCoverPage","summary":"Send a fax with cover page","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFaxWithCoverPage"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax":{"value":{"to":"+14155552222","file":"//path/to/file.pdf"},"key":"SendFileAsFax","summary":"Send a file as a fax","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/multipart~1form-data/examples/SendFileAsFax"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxWithCoverPage":{"value":{"to":"+14155552222","file":"//path/to/file.pdf","coverPageId":"12312kj312kl3j12k3j","coverPageData":{"message":"To Dr. Smith regarding referral"}},"key":"SendFileAsFaxWithCoverPage","summary":"Send a fax with cover page","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxWithCoverPage"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendWebPageAsFax":{"value":{"to":"+14155552222","contentUrl":"https://developers.sinch.com/fax/fax.pdf"},"key":"SendWebPageAsFax","summary":"Send a web page as a fax","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendWebPageAsFax"},"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxJson":{"value":{"to":["+14155552222","+14155552233"],"files":[{"file":"{base64EncodedData}","fileType":"PDF"}]},"key":"SendFileAsFaxJson","summary":"Send a file as a fax","id":"paths/~1v3~1projects~1{projectId}~1faxes/post/requestBody/content/application~1json/examples/SendFileAsFaxJson"},"paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example":{"value":{"id":"01HDF5S9P29WC29J578J8EKC1C","direction":"OUTBOUND","to":"+1234567890","status":"IN_PROGRESS","headerTimeZone":"America/New_York","retryDelaySeconds":60,"callbackUrl":"https://my.callback.server","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID","maxRetries":3,"createTime":"2023-10-23T21:06:52.231Z","headerPageNumbers":true,"contentUrl":"https://www.google.com","imageConversionMethod":"HALFTONE"},"id":"paths/~1v3~1projects~1{projectId}~1faxes/post/responses/200/content/application~1json/example"},"paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example":{"value":{"id":"01HDF5S9P29WC29J578J8EKC1C","direction":"OUTBOUND","to":"+1234567890","status":"IN_PROGRESS","headerTimeZone":"America/New_York","retryDelaySeconds":60,"callbackUrl":"https://my.callback.server","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID","maxRetries":3,"createTime":"2023-10-23T21:06:52.231Z","headerPageNumbers":true,"contentUrl":["www.google.com"],"imageConversionMethod":"HALFTONE","hasFile":false},"id":"paths/~1v3~1projects~1{projectId}~1faxes~1{id}/get/responses/200/content/application~1json/example"},"paths/incomingFax/post/requestBody/content/multipart~1form-data/example":{"value":{"event":"INCOMING_FAX","eventTime":"2021-11-01T23:25:57Z","fax":{"id":"01HDFHACK1YN7CCDYRA6ZRMA8Z","direction":"INBOUND","from":"+14155552222","to":"+14155553333","numberOfPages":1,"status":"COMPLETED","price":{"amount":"0.00","currencyCode":"USD"},"createTime":"2021-11-01T23:25:57Z","completedTime":"2021-11-01T23:25:57Z","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID"},"file":"{application/pdf}"},"id":"paths/incomingFax/post/requestBody/content/multipart~1form-data/example"},"paths/incomingFax/post/requestBody/content/application~1json/example":{"value":{"event":"INCOMING_FAX","eventTime":"2021-11-01T23:25:57Z","fax":{"id":"01HDFHACK1YN7CCDYRA6ZRMA8Z","direction":"INBOUND","from":"+14155552222","to":"+14155553333","numberOfPages":1,"status":"COMPLETED","price":{"amount":"0.00","currencyCode":"USD"},"createTime":"2021-11-01T23:25:57Z","completedTime":"2021-11-01T23:25:57Z","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID"},"file":"{base64_encodedData}","fileType":"PDF"},"id":"paths/incomingFax/post/requestBody/content/application~1json/example"},"paths/faxCompleted/post/requestBody/content/multipart~1form-data/example":{"value":{"event":"FAX_COMPLETED","eventTime":"2021-11-01T23:25:57Z","fax":{"id":"01HDFHACK1YN7CCDYRA6ZRMA8Z","direction":"INBOUND","from":"+14155552222","to":"+14155553333","numberOfPages":1,"status":"COMPLETED","price":{"amount":"0.07","currencyCode":"USD"},"createTime":"2021-11-01T23:25:57Z","completedTime":"2021-11-01T23:25:57Z","callbackUrl":"https://www.my-website.com/callback","callbackUrlContentType":"multipart/form-data","imageConversionMethod":"HALFTONE","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID"},"file":"{application/pdf}"},"id":"paths/faxCompleted/post/requestBody/content/multipart~1form-data/example"},"paths/faxCompleted/post/requestBody/content/application~1json/example":{"value":{"event":"FAX_COMPLETED","eventTime":"2021-11-01T23:25:57Z","fax":{"id":"01HDFHACK1YN7CCDYRA6ZRMA8Z","direction":"INBOUND","from":"+14155552222","to":"+14155553333","numberOfPages":1,"status":"COMPLETED","price":{"amount":"0.07","currencyCode":"USD"},"createTime":"2021-11-01T23:25:57Z","completedTime":"2021-11-01T23:25:57Z","callbackUrl":"https://www.my-website.com/callback","callbackUrlContentType":"application/json","projectId":"YOUR_PROJECT_ID","serviceId":"YOUR_SERVICE_ID"},"files":[{"file":"{base64ecnodeddata}","fileType":"PDF"}]},"id":"paths/faxCompleted/post/requestBody/content/application~1json/example"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example":{"value":{"email":"user@domain.com","phoneNumbers":[{"faxNumber":"+14155552222","permissions":"both"}]},"id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails/post/requestBody/content/application~1json/example"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example":{"value":{"phoneNumbers":[{"faxNumber":"+14155552222","permissions":"both"}]},"id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1emails~1{email}/put/requestBody/content/application~1json/example"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax":{"value":{"template":"

Hi,

You have sent a successful fax to: {{to}}!

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Completed at:{{completedTime}}
Price:{{currencyCode}} {{amount}}

Thanks!

"},"key":"successfulOutboundFax","summary":"successful outbound fax","id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulOutboundFax"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax":{"value":{"template":"

Hi,

You have received a successful fax from: {{from}}!

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Completed at:{{completedTime}}
Price:{{currencyCode}} {{amount}}

Thanks!

"},"key":"successfulInboundFax","summary":"successful inbound fax","id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/successfulInboundFax"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax":{"value":{"template":"

Hi,

A fax you sent to: {{to}} was not sent successfully.

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Number of retries:{{retryCount}}
Price:{{currencyCode}} {{amount}}

Thanks!

"},"key":"unsuccessfulOutboundFax","summary":"unsuccessful outbound fax","id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulOutboundFax"},"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax":{"value":{"template":"

Hi,

A fax sent to you from: {{from}} was not received successfully.

Fax Id:{{id}}
From:{{from}}
To:{{to}}
Number of pages:{{numberOfPages}}
Number of retries:{{retryCount}}
Price:{{currencyCode}} {{amount}}

Thanks!

"},"key":"unsuccessfulInboundFax","summary":"unsuccessful inbound fax","id":"paths/~1v3~1projects~1{projectId}~1services~1{serviceId}~1domains~1{domainName}~1templates~1{templateName}/put/requestBody/content/application~1json/examples/unsuccessfulInboundFax"}},"securitySchemeStore":{"WebhookBasicAuth":{"id":"WebhookBasicAuth","type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can validate whether a webhook is genuine by providing credentials you set and will check on your server side along with the callback URL, as in this example: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://username:password@www.YourWebhookWebsite.com"},"children":[]}]}]}]},"BasicAuth":{"id":"BasicAuth","type":"http","scheme":"basic","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your keyId and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}]},"OAuth2":{"id":"OAuth2","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user name and password is your key id and key secret from the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://dashboard.sinch.com/settings/access-keys"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access keys sections"},"children":[]}]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://auth.sinch.com/oauth2/token","scopes":{}}}}},"servers":[{"url":"https://fax.api.sinch.com","description":"v3.0 of the Fax API"}],"specType":"openapi"},"options":{"sortRequiredPropsFirst":true,"mockServer":{"url":"/_mock/docs/fax/api-reference/fax","position":"off","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/docs/fax/api-reference/fax.json?download"},{"url":"/_bundle/docs/fax/api-reference/fax.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Fax API","description":"This document provides a detailed user guide and reference documentation on the Fax REST API.\n\nIf you have questions please contact us via our [support portal](https://support.sinch.com) and a team member will be happy to assist.\n\n{% admonition type=\"info\" name=\"Note:\" %}\nYou must create an account on our support portal if you do not have one.\n{% /admonition %}\n\n## Authentication\n\nFor information on how to authenticate API requests we support two methods [Basic](https://developers.sinch.com/docs/fax/api-reference/authentication/basic) or [Oauth2](https://developers.sinch.com/docs/fax/api-reference/authentication/oauth)\n\n## Global URL\n\nSinch has a global server that will route your call to the appropriate geography region automatically:\n\n```shell\nhttps://fax.api.sinch.com/\n```\n\n## Formats\n\nBy default, all API calls return a JSON response unless otherwise specified.\n\n### Date time fields\n\nAll date and time fields are in UTC format unless otherwise specified.\n\n## Deletion and data retention\n\nIf you have enabled storage, we retain fax logs and media for 13 months which you can access via the API. After 13 months, media and logs are deleted.\n\n## Errors & statuses\n\nFind error codes and explanations [here](https://developers.sinch.com/docs/fax/api-reference/fax/error-messages).\n\n## Webhooks\n\nYou can configure your service to use webhooks to send a request to you when faxes arrive or complete on your account.\n\n**Note:** When webhooks with Basic authentication credentials are shown in GET requests, the credentials are masked with `***`` symbols. It is not possible to retrieve previously-set credentials through the API.\n"}},"baseSlug":"/docs/fax/api-reference/fax","routesMapping":{}}