{"info":{"_postman_id":"2bd20c8f-e97b-4afa-9a5b-de33b28d794b","name":"Documo - Fax API - User access only","description":"# Introduction\n## Getting Started\nThe Documo API is organized around REST. All calls to the Documo API should be made to [https://api.documo.com](https://api.documo.com). All responses are formatted in JSON.\n## Enabling API access\nTo begin using the Documo API, you will need to enable the API and generate an API key. This can be done in the Admin console in Account Settings: API. Visual instructions [here](help.documo.com)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json"},"item":[{"name":"me","item":[{"name":"Get current user","id":"b1ac3cb7-33eb-4903-ab6a-b86e73a17fa9","request":{"method":"GET","header":[],"url":"https://api.documo.com/v1/me","description":"Returns current logged in user with fax numbers and account"},"response":[],"_postman_id":"b1ac3cb7-33eb-4903-ab6a-b86e73a17fa9"}],"id":"cf8c9747-9584-40de-9b12-a719a4761d39","_postman_id":"cf8c9747-9584-40de-9b12-a719a4761d39"},{"name":"contacts","item":[{"name":"Get contact","id":"20614ebd-7109-4b70-90cc-aa8eecbb9edb","request":{"method":"GET","header":[],"url":{"raw":"https://api.documo.com/v1/contacts?userId={{userId}}&limit={{limit}}&offset={{offset}}&order={{order}}&query={{query}}","protocol":"https","host":["api","documo","com"],"path":["v1","contacts"],"query":[{"key":"userId","value":"{{userId}}","description":"User ID. If not specified - returns results for current user"},{"key":"limit","value":"{{limit}}","description":"Amount of line items per page that will be returned"},{"key":"offset","value":"{{offset}}","description":"Number of pages to return"},{"key":"order","value":"{{order}}","description":"Order results. Ordered by name in ascending order, default value is name asc"},{"key":"query","value":"{{query}}","description":"Search by contact name, fax number, phone number or email"}]},"description":"Returns contact list"},"response":[],"_postman_id":"20614ebd-7109-4b70-90cc-aa8eecbb9edb"},{"name":"Create contact","id":"23d4145a-1f59-45ce-8029-8f11dbb1037b","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"phoneNumber","value":"{{phoneNumber}}","type":"text","description":"Phone number in format (***) ***-****"},{"key":"faxNumber","value":"{{faxNumber}}","type":"text","description":"Fax number in format (***) ***-****. Required for sending fax using contact"},{"key":"name","value":"{{name}}","type":"text","description":"Contact name"},{"key":"email","value":"{{email}}","type":"text","description":"Contact email"},{"key":"isPublic","value":"{{isPublic}}","type":"text","description":"Contact will be shown for all users in the account"},{"key":"publicEditable","value":"{{publicEditable}}","type":"text","description":"All account users will be able to edit contact if value is true"},{"key":"organizationId","value":"{{organizationId}}","type":"text","description":"Assign contact to existing organization contact"},{"key":"isOrganization","value":"{{isOrganization}}","type":"text","description":"If true - organization will be created"}]},"url":{"raw":"https://api.documo.com/v1/contacts?userId={{userId}}","protocol":"https","host":["api","documo","com"],"path":["v1","contacts"],"query":[{"key":"userId","value":"{{userId}}","description":"User ID. If not specified - creates contact for current user"}]},"description":"Creates a contact"},"response":[],"_postman_id":"23d4145a-1f59-45ce-8029-8f11dbb1037b"},{"name":"Update contact","id":"845e3924-5fe1-4424-a811-dbf230e55dda","request":{"method":"PATCH","header":[],"body":{"mode":"formdata","formdata":[{"key":"phoneNumber","value":"{{phoneNumber}}","type":"text","description":"Phone number in format (***) ***-****"},{"key":"faxNumber","value":"{{faxNumber}}","type":"text","description":"Fax number in format (***) ***-****. Required for sending fax using contact"},{"key":"name","value":"{{name}}","type":"text","description":"Contact name"},{"key":"email","value":"{{email}}","type":"text","description":"Contact email"},{"key":"isPublic","value":"{{isPublic}}","type":"text","description":"Contact will be shown for all users in the account"},{"key":"publicEditable","value":"{{publicEditable}}","type":"text","description":"All account users will be able to edit contact if value is true"},{"key":"organizationId","value":"{{organizationId}}","type":"text","description":"Assign contact to existing organization contact"}]},"url":{"raw":"https://api.documo.com/v1/contacts/:contactId","protocol":"https","host":["api","documo","com"],"path":["v1","contacts",":contactId"],"variable":[{"description":"Contact ID","key":"contactId","value":"{{contactId}}"}]},"description":"Creates a contact"},"response":[],"_postman_id":"845e3924-5fe1-4424-a811-dbf230e55dda"},{"name":"Bulk delete contacts","id":"2b220fca-21b4-463f-8697-f1164db82591","request":{"method":"DELETE","header":[],"url":{"raw":"https://api.documo.com/v1/contacts/bulk?contactsIds={{contactsIds}}","protocol":"https","host":["api","documo","com"],"path":["v1","contacts","bulk"],"query":[{"key":"contactsIds","value":"{{contactsIds}}","description":"Contact IDs"}]},"description":"Deletes contacts bulk"},"response":[],"_postman_id":"2b220fca-21b4-463f-8697-f1164db82591"},{"name":"Delete contact","id":"7828be94-5580-4770-8f47-060bde3c831a","request":{"method":"DELETE","header":[],"url":{"raw":"https://api.documo.com/v1/contacts/:contactId","protocol":"https","host":["api","documo","com"],"path":["v1","contacts",":contactId"],"variable":[{"description":"Contact ID","key":"contactId","value":"{{contactId}}"}]},"description":"Deletes contact"},"response":[],"_postman_id":"7828be94-5580-4770-8f47-060bde3c831a"}],"id":"dea6ab82-56a5-4fdb-8658-dc14febdf2dc","_postman_id":"dea6ab82-56a5-4fdb-8658-dc14febdf2dc"},{"name":"fax","item":[{"name":"Fax send","id":"85f38f27-754f-444a-a9cc-4caca6a64571","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"recipientFax","value":"{{recipientFax}}","type":"text","description":"Destination phone number. Country code must be included (ex. 18885551234). Multiple destinations separated by comma.\n"},{"key":"recipientContacts","value":"{{recipientContacts}}","type":"text","description":"Contact IDs separated by comma\n"},{"key":"coverPage","value":"{{coverPage}}","type":"text","description":"Defaults to false. Indicating true will include system cover page. If coverPage is added, this removes file requirement.\n"},{"key":"recipientName","value":"{{recipientName}}","type":"text","description":"Will populate in TO field of cover page\n"},{"key":"subject","value":"{{subject}}","type":"text","description":"Will populate Subject field of cover page"},{"key":"notes","value":"{{notes}}","type":"text","description":"Will populate Notes field of cover page\n"},{"key":"callerId","value":"{{callerId}}","type":"text","description":"Phone number. Defaults to user setting if not included in call.\n"},{"key":"coverPageId","value":"{{coverPageId}}","type":"text","description":"Coverpage ID"},{"key":"tags","value":"{{tags}}","type":"text","description":"Comma separated tag IDs list"},{"key":"file","value":null,"description":"File(s) you wish to fax. Add files to the stream in order they should be rendered. At least 1 file is required if coverPage parameter is not added.\n","type":"file"}]},"url":"https://api.documo.com/v1/fax/send","description":"Sends a fax"},"response":[],"_postman_id":"85f38f27-754f-444a-a9cc-4caca6a64571"},{"name":"Fax resend","id":"1cda870a-d5a8-4fd2-ad46-2b61326e55bc","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"messageId","value":"{{messageId}}","type":"text","description":"Unique message identifier provided by Documo"},{"key":"recipientFax","value":"{{recipientFax}}","type":"text","description":"Use this parameter to change destination phone number.\n"}]},"url":"https://api.documo.com/v1/fax/resend","description":"Resend fax"},"response":[],"_postman_id":"1cda870a-d5a8-4fd2-ad46-2b61326e55bc"},{"name":"Get fax info","id":"188dbb87-dbd7-4c59-aefe-e6a520ee669e","request":{"method":"GET","header":[],"url":{"raw":"https://api.documo.com/v1/fax/:messageId/info","protocol":"https","host":["api","documo","com"],"path":["v1","fax",":messageId","info"],"variable":[{"description":"Unique message identifier provided by Documo","key":"messageId","value":"{{messageId}}"}]},"description":"Returns fax"},"response":[],"_postman_id":"188dbb87-dbd7-4c59-aefe-e6a520ee669e"},{"name":"Get fax history","id":"48004df2-09a0-4ac4-a13c-f4aaf62b01a2","request":{"method":"GET","header":[],"url":{"raw":"https://api.documo.com/v1/fax/history?offset=0&limit=20&direction=all&status=all&fromDate={{fromDate}}&toDate={{toDate}}&accountId={{accountId}}&userId={{userId}}&query={{query}}&tags={{tags}}&archived={{archived}}&include={{include}}","protocol":"https","host":["api","documo","com"],"path":["v1","fax","history"],"query":[{"key":"offset","value":"0","description":"Number of pages to return\n"},{"key":"limit","value":"20","description":"Amount of line items per page that will be returned"},{"key":"direction","value":"all","description":"Filters results by direction. Can indicate all (default), inbound or outbound\n"},{"key":"status","value":"all","description":"Filters results by status. Can indicate all (default), failed, success, or processing\n"},{"key":"fromDate","value":"{{fromDate}}","description":"Filters results from starting date. (ex. 2012-04-23T18:25:43.511Z)\n"},{"key":"toDate","value":"{{toDate}}","description":"Filters results up to end date. (ex. 2012-04-23T18:25:43.511Z)\n"},{"key":"accountId","value":"{{accountId}}","description":"Filters results by Account ID\n"},{"key":"userId","value":"{{userId}}","description":"Filters results by User ID"},{"key":"query","value":"{{query}}","description":"Search by CSID, Caller ID, fax number and message id.\n"},{"key":"tags","value":"{{tags}}","description":"Filters by comma separated tags list"},{"key":"archived","value":"{{archived}}","description":"Filters by archived faxes if true"},{"key":"include","value":"{{include}}","description":"Include assigned contacts or tags. Example: tags,contacts"}]},"description":"Returns fax list of current user"},"response":[],"_postman_id":"48004df2-09a0-4ac4-a13c-f4aaf62b01a2"},{"name":"Download fax","id":"b7b5735f-e0e0-409d-b95e-ca0e3814f920","request":{"method":"GET","header":[],"url":{"raw":"https://api.documo.com/v1/fax/download?messageId={{messageId}}&extension={{extension}}","protocol":"https","host":["api","documo","com"],"path":["v1","fax","download"],"query":[{"key":"messageId","value":"{{messageId}}","description":"Unique message identifier provided by Documo\n"},{"key":"extension","value":"{{extension}}","description":"File extension. Default is pdf, tiff is also available\n"}]},"description":"Download fax files"},"response":[],"_postman_id":"b7b5735f-e0e0-409d-b95e-ca0e3814f920"},{"name":"Delete fax","id":"3d502724-9247-4cf3-947e-558d4816352a","request":{"method":"DELETE","header":[],"url":{"raw":"https://api.documo.com/v1/fax/:messageId","protocol":"https","host":["api","documo","com"],"path":["v1","fax",":messageId"],"variable":[{"description":"Unique message identifier provided by Documo","key":"messageId","value":"{{messageId}}"}]},"description":"Removes fax"},"response":[],"_postman_id":"3d502724-9247-4cf3-947e-558d4816352a"}],"id":"adcfbf81-8a22-4451-b987-e70eb0982a90","_postman_id":"adcfbf81-8a22-4451-b987-e70eb0982a90"},{"name":"tags","item":[{"name":"Get tags","id":"79a523e6-7299-4af5-9e3e-940493ebc4a7","request":{"method":"GET","header":[],"url":"https://api.documo.com/v1/tags","description":"get current user tags list"},"response":[],"_postman_id":"79a523e6-7299-4af5-9e3e-940493ebc4a7"},{"name":"Get fax tags","id":"f422188d-5c21-4e52-8b49-3f321a4ebaad","request":{"method":"GET","header":[],"url":{"raw":"https://api.documo.com/v1/fax/:messageId/tags","protocol":"https","host":["api","documo","com"],"path":["v1","fax",":messageId","tags"],"variable":[{"description":"Fax Message ID","key":"messageId","value":"{{messageId}}"}]},"description":"Get all tags of fax"},"response":[],"_postman_id":"f422188d-5c21-4e52-8b49-3f321a4ebaad"},{"name":"Create tag","id":"06fd2f7a-feb6-42a5-8632-207d60b1ca5e","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"name","value":"{{name}}","type":"text","description":"Tag name"},{"key":"color","value":"{{color}}","type":"text","description":"Tag color hex"},{"key":"isPublic","value":"false","type":"text","description":"Tag will be shown for all users in the account"}]},"url":"https://api.documo.com/v1/tag","description":"create a tag"},"response":[],"_postman_id":"06fd2f7a-feb6-42a5-8632-207d60b1ca5e"},{"name":"Add fax tag","id":"326ff532-a16b-41e6-86e9-3d7db07cb15d","request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"tagId","value":"{{tagId}}","type":"text","description":"Tag ID"}]},"url":{"raw":"https://api.documo.com/v1/fax/:messageId/tag","protocol":"https","host":["api","documo","com"],"path":["v1","fax",":messageId","tag"],"variable":[{"description":"Fax Message ID","key":"messageId","value":"{{messageId}}"}]},"description":"add a tag to a fax"},"response":[],"_postman_id":"326ff532-a16b-41e6-86e9-3d7db07cb15d"},{"name":"Delete fax tag","id":"ee8eb95b-ef59-4e01-9191-edfe3c154da3","request":{"method":"DELETE","header":[],"url":{"raw":"https://api.documo.com/v1/fax/:messageId/tag/:tagId","protocol":"https","host":["api","documo","com"],"path":["v1","fax",":messageId","tag",":tagId"],"variable":[{"description":"Fax Message ID","key":"messageId","value":"{{messageId}}"},{"description":"Tag ID","key":"tagId","value":"{{tagId}}"}]},"description":"delete tag"},"response":[],"_postman_id":"ee8eb95b-ef59-4e01-9191-edfe3c154da3"},{"name":"Delete tag","id":"e8f261e4-0228-4bf3-a4c5-c9532a092109","request":{"method":"DELETE","header":[],"url":{"raw":"https://api.documo.com/v1/tag/:tagId","protocol":"https","host":["api","documo","com"],"path":["v1","tag",":tagId"],"variable":[{"description":"Tag ID","key":"tagId","value":"{{tagId}}"}]},"description":"delete a tag"},"response":[],"_postman_id":"e8f261e4-0228-4bf3-a4c5-c9532a092109"}],"id":"fcb0bc23-56e1-4acc-a518-c51d5c582df1","_postman_id":"fcb0bc23-56e1-4acc-a518-c51d5c582df1"},{"name":"settings","item":[{"name":"Update user","id":"f4e4ac14-4791-43f0-9775-7930de3ad8a6","request":{"method":"PATCH","header":[],"body":{"mode":"formdata","formdata":[{"key":"firstName","value":"{{firstName}}","type":"text","description":"First name on the card"},{"key":"lastName","value":"{{lastName}}","type":"text","description":"Last name on the card"},{"key":"userRole","value":"{{userRole}}","type":"text","description":"User role"},{"key":"phone","value":"{{phone}}","type":"text","description":"User phone"},{"key":"faxCallerId","value":"{{phone}}","type":"text","description":"ID of fax caller"},{"key":"faxCsid","value":"{{faxCsid}}","type":"text","description":"Unique fax ID"},{"key":"emailNotifySendOption","value":"all","type":"text","description":"Outbound fax notification settings. Acceptable values: None, All (default), Success, Failure"},{"key":"emailNotifyReceiveOption","value":"all","type":"text","description":"Inbound fax notification settings. Acceptable values: None, All (default), Success, Failure"},{"key":"emailNotifySendIncAttachment","value":true,"type":"text","description":"Outbound fax notification attachment settings. Acceptable values: true (default), false"},{"key":"emailNotifyReceiveIncAttachment","value":true,"type":"text","description":"Inbound fax notification attachment settings. Acceptable values: true (default), false"},{"key":"emailToFaxCoverPageOption","value":true,"type":"text","description":"Email to Fax cover page option"},{"key":"faxExtension","value":"{{faxExtension}}","type":"text","description":"Extension '.pdf' or '.tiff'"},{"key":"webhookUrl","value":"{{webhookUrl}}","description":"POST request to webhookUrl when received income fax. URL should start with http:// or https://","type":"text"}]},"url":{"raw":"https://api.documo.com/v1/users/:userId","protocol":"https","host":["api","documo","com"],"path":["v1","users",":userId"],"variable":[{"key":"userId","value":"{{userId}}"}]},"description":"Updates user data by user's userId"},"response":[],"_postman_id":"f4e4ac14-4791-43f0-9775-7930de3ad8a6"}],"id":"49c179b2-775f-4c5e-9715-39698b9831fa","_postman_id":"49c179b2-775f-4c5e-9715-39698b9831fa"}],"auth":{"type":"bearer","bearer":{"token":"{{API_KEY}}"}},"event":[{"listen":"prerequest","script":{"id":"556c597b-05c5-4004-b42c-ea9fa61d9aee","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"29178d7c-9f96-4571-a2b5-04f022e1ca52","type":"text/javascript","exec":[""]}}]}