Fax Configuration API (2.0)

The fax configuration API allows you to administer:

  • Mail to Fax
  • Fax to Email
  • Fax to FTP
  • Fax to Webservice
Download OpenAPI description
Languages
Servers
Mock server
https://developers.retarus.com/_mock/fax/fax-config-api/
Production
https://fax-config.de2.retarus.com/v2/

Inbound Fax

View and configure inbound fax numbers

Operations

Inbound Fax Profiles

View and configure inbound fax profiles

Operations

Mail to Fax

View and configure email to fax users

Operations

Retrieve a Mail2Fax user

Request

Retrieve a Mail2Fax user

Path
userstringrequired

The users email address

Example: john.smith@retarus.com
curl -i -X GET \
  -u <username>:<password> \
  'https://developers.retarus.com/_mock/fax/fax-config-api/outbound/users/{user}'

Responses

The configuration for the requested Mail2Fax user

Bodyapplication/json
emailstring
generalobject(GeneralUserSettings)
faxobject(FaxSettings)
dialingobject(DialingSettings)
reportEmailobject(ReportEmailSettings)
coverSheetobject(CoverSheetSettings)
personalizationobject
Response
application/json

A typical Mail2Fax user with only a user specific cost center and a few personalization values

{ "email": "john.smith@retarus.com", "personalization": { "department": "Sales", "title": "Sales Representative" }, "general": { "client": "default", "profile": "default" }, "fax": { "costCenter": "Sales-USA" } }

Upsert a Mail2Fax user

Request

Create a new or update an existing Mail2Fax user

Path
userstringrequired

The users email address

Example: john.smith@retarus.com
Bodyapplication/jsonrequired

A complete MailToFaxUser representation

emailstring
generalobject(GeneralUserSettings)
faxobject(FaxSettings)
dialingobject(DialingSettings)
reportEmailobject(ReportEmailSettings)
coverSheetobject(CoverSheetSettings)
personalizationobject
curl -i -X PUT \
  'https://developers.retarus.com/_mock/fax/fax-config-api/outbound/users/{user}' \
  -H 'Content-Type: application/json' \
  -d '{
    "personalization": {
      "department": "Sales",
      "title": "Sales Representative"
    },
    "general": {
      "client": "default",
      "profile": "default",
      "active": true
    },
    "fax": {
      "costCenter": "Sales-USA"
    }
  }'

Responses

Mail2Fax user updated

Response
application/json
{ "code": 401, "message": "Credentials are required to access this resource." }

Delete a Mail2Fax user

Request

Delete a Mail2Fax user

Path
userstringrequired

The Mail2Fax user's email address

Example: john.smith@retarus.com
curl -i -X DELETE \
  -u <username>:<password> \
  'https://developers.retarus.com/_mock/fax/fax-config-api/outbound/users/{user}'

Responses

Mail2Fax user deleted

Response
application/json
{ "code": 401, "message": "Credentials are required to access this resource." }

Patch a Mail2Fax user

Request

Patch (update) a Mail2Fax user

Path
userstringrequired

The users email address

Example: john.smith@retarus.com
Bodyapplication/json-patch+jsonrequired

A json patch object according to RFC 6902

Array [
opstringrequired

The operation to be performed

Enum"add""remove""replace""move""copy""test"
pathstringrequired

A JSON-Pointer

valueobject

The value to be used within the operations.

fromstring

A string containing a JSON Pointer value.

]
curl -i -X PATCH \
  -u <username>:<password> \
  'https://developers.retarus.com/_mock/fax/fax-config-api/outbound/users/{user}' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
    "path": "/fax",
    "value": {
      "costCenter": "Retarus-Sales-USA"
    },
    "op": "add"
  }'

Responses

Mail2Fax user updated

Response
application/json
{ "code": 401, "message": "Credentials are required to access this resource." }

Retrieve Mail2Fax users

Request

Retrieve Mail2Fax users

Query
profilestring

Retrieve only users that are assigned to the specified profile

Example: profile=default
clientstring

Retrieve only users that are assigned to the specified client

Example: client=default
searchstring

Retrieve only users whose email address, profile or client matches the specified search string

Example: search=john.smith@retarus.com
fuzzystring

Switch between exact- and contains-match

limitinteger(int32)

Number of users to return in the response

Default 100
offsetinteger(int32)

Retrieve users starting with the offset

Default 0
templatestring

Retrieve users with the specified coverpage template

Example: template=coverpage_us_sales.rtf
curl -i -X GET \
  -u <username>:<password> \
  'https://developers.retarus.com/_mock/fax/fax-config-api/outbound/users?client=string&fuzzy=string&limit=100&offset=0&profile=string&search=string&template=string'

Responses

#FIXME Add a description

Bodyapplication/jsonArray [
emailstring
generalobject(GeneralUserSettings)
faxobject(FaxSettings)
dialingobject(DialingSettings)
reportEmailobject(ReportEmailSettings)
coverSheetobject(CoverSheetSettings)
personalizationobject
]
Response
application/json
[ { "email": "john.smith@retarus.com", "personalization": {}, "general": {}, "fax": {} }, { "email": "max.mustermann@retarus.de", "personalization": {}, "general": {}, "fax": {} } ]

Mail to Fax Profiles

View and configure email to fax profiles

Operations

Joint Outbound and Inbound

Retrieve joined Mail to Fax user and Fax to Mail number

Operations