# Set Account Digital Signature Provider Sets the customer's digital signature provider. Endpoint: POST /api/v3/digital_signatures/accounts/providers Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `provider_id` (integer, required) Id of a provider (see the providers list). Missing or unknown → 404. Example: 1 - `client_id` (string, required) Example: "3b897ad6-cce4-4c54-a7e7-2bd00b83ab85" - `client_secret` (string, required) Example: "ChvH5AUVhLNU" - `consent_agreement` (boolean, required) Must be true; false or missing → 422 (consent_agreement: ["can't be blank"]). Enum: true ## Response 201 fields (application/json): - `id` (integer) Example: 1 - `name` (string) Example: "Multicert" - `description` (string) Localized text in the account language. May contain HTML (e.g. an `` link for Multicert); render or strip it accordingly. Empty string when there is no text for the provider. Example: "Digitally sign your documents using the Electronic Invoice Signing Service (SAFE)." - `identifier` (string) Example: "multicert" - `grant_type` (string) OAuth grant type used by this provider Example: "client_credentials" - `url_image` (string) Example: "/digital_signatures/providers/multicert-logo.png" - `url_guide` (string) Example: "https://invoicexpress.helpscoutdocs.com/article/347-assinatura-digital-guia-passo-a-passo-para-a-ativacao" - `url_auth` (string) OAuth authorization URL to opt into this provider Example: "https://preprod.autenticacao.gov.pt/oauth/askauthorization" - `in_use` (boolean) Whether this provider is the one currently active for the account - `expired` (boolean,null) - `expiration_date` (string,null) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (string) Raw error message — not the usual array-of-objects error shape used elsewhere in this API Example: "Couldn't find DsAccountProvider with [WHERE `ds_account_providers`.`account_id` = ?]" ## Response 503 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)