From Safe Stamper API
Jump to: navigation, search

This operation creates a user in Safe Stamper, or creates an authorization for an existing Safe Stamper user.



  • sharedkey: Your API client shared key
  • signature: Parameters signature, as explained in Signature parameter
  • mail*: user mail
  • firstName?: first name of the user
  • lastName?: last name of the user
  • address1: user address line 1
  • address2: user address line 2
  • zip: user address zip code
  • city: user address zip city
  • countrycode: user address country ISO code (Default 'ES')
  • language: user preferred language (es|en) Defaults to the language of the api client.
  • notifyActivity: (true|false) whether the user wants to receive an e-mail with a list of the e-mail certificates that have been generated with the user's account each day.

Partners may include this param:

  • accounttype: account type that will be enabled to the user (professional|corporate)

* Required parameter

(?): At least provide one field (First or last name)


A JSON object with the authkey status, as returned in authstate:

  • authkey: Authkey value
  • authorized: State of authkey (true|false).
  • state: State of Safe Stamper operator (ACTIVE|DISABLED)
  • userCode: Safe Stamper code of the user.
  • userMail: Mail of the user.
  • userName: Full name of the user.
  • accountType: Account type of the main user (BASIC|PREMIUM).
  • userType: User type of the user (INDIVIDUAL|ORGANIZATION).
  • availableCertificates: Available certification credits to use web static, mail, file and photo services.
  • availableNavigations: Available certification credits to use browsing session services.
  • availableTimestamps: Available timestamp credits to use tsa services.
  • maxCertificateSize: Máx size in bytes for certificates
  • maxCertificateSizeMb: Máx size in MB for certificates

HTTP Errors

  • 400 Bad Request: the countrycode or accounttype are not valid, or firstname and lastname are empty
  • 401 Unauthorized: accounttype is sended but you are not a partner
  • 403 Forbidden: the sharedkey is not valid, or the e-mail address already exists in Safe Stamper or Safe Creative



RESPONSE (actual response has no line breaks or indentation):

     "userMail" : "",
     "userName":"Api User Test"