> ## Documentation Index > Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt > Use this file to discover all available pages before exploring further. # Save E Mail Account > Updates the existing EMailAccount or creates a new EMailAccount if the id parameter is 0. NsApiSlow threshold: 5000 ms. ## Online Restricted: ## The EMail agent is not available in Online by default. Access must be requested specifically when app is registered. ## OpenAPI ````yaml /openapi/agent/openapi-v3-EMailAgent.json post /api/v1/Agents/EMail/SaveEMailAccount openapi: 3.0.0 info: version: v1-Agents title: SuperOffice Agent API v1 description: SuperOffice Agent API - EMailAgent contact: name: SuperOffice DevNet url: https://docs.superoffice.com/en/api/index.html email: sdk@superoffice.com servers: - url: http://localhost:56350 - url: https://localhost:56350 security: [] tags: [] externalDocs: description: >- The SuperOffice DevNet Community has more documentation, examples, and discussion forums. url: https://community.superoffice.com/en/developer/ paths: /api/v1/Agents/EMail/SaveEMailAccount: post: tags: - EMail_Agent summary: Save E Mail Account description: "Updates the existing EMailAccount or creates a new EMailAccount if the id parameter is 0.\n\nNsApiSlow threshold: 5000 ms.\r\n## Online Restricted: ## The EMail agent is not available in Online by default. Access must be requested specifically when app is registered." operationId: v1EMailAgent_SaveEMailAccount parameters: - name: Accept-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. required: false schema: type: string - name: SO-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. required: false schema: type: string - name: SO-Culture in: header description: >- Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. required: false schema: type: string - name: SO-TimeZone in: header description: >- Specify the timezone code that you would like date/time responses converted to. required: false schema: type: string - name: SO-AppToken in: header description: >- The application token that identifies the partner app. Used when calling Online WebAPI from a server. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' description: The EMailAccount that is saved required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.EMailAccount' security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.CRM.Services.EMailAccount: description: "Properties for an email account\r\n\r\nCarrier object for EMailAccount.\r\nServices for the EMailAccount Carrier is available from the EMail Agent." type: object properties: EMailAccountId: format: int32 description: The account primary key type: integer EMailAddress: description: The account (from) address type: string AssociateId: format: int32 description: Id of the associate who owns this account type: integer IncomingCredentials: $ref: '#/components/schemas/SuperOffice.CRM.Services.ServiceAuth' OutgoingCredentials: $ref: '#/components/schemas/SuperOffice.CRM.Services.ServiceAuth' AccountStatus: format: int32 description: The account status (Disabled or...) Readonly field type: integer ErrorCount: format: int32 description: Count of concurring errors of fetching email. Readonly field type: integer ErrorReason: description: Reason/Error message. Readonly field type: string InboxFolder: description: Inbox folder name if available in the db type: string SentFolder: description: Sent email folder name if available in the db type: string LastFetch: format: date-time description: When we last fetched email in UTC. type: string UseGraphApi: format: int32 description: Use the GraphApi for this account type: integer TableRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight' FieldProperties: description: >- Field property dictionary mapping field names to field access rights. type: object additionalProperties: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty' SuperOffice.CRM.Services.ServiceAuth: description: "Properties for service authentication\r\n\r\nCarrier object for ServiceAuth.\r\nServices for the ServiceAuth Carrier is available from the User Agent." type: object properties: ServiceAuthId: format: int32 description: The primary key type: integer Server: description: The mail server type: string Port: format: int32 description: The server port type: integer AuthType: description: The type of authentication, plain-text, OAuth... type: string Username: description: The username type: string Password: description: The (decrypted) password or token type: string TableRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight' FieldProperties: description: >- Field property dictionary mapping field names to field access rights. type: object additionalProperties: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty' SuperOffice.CRM.Security.TableRight: description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted." type: object properties: Mask: type: string Reason: type: string SuperOffice.CRM.Security.FieldProperty: description: >- Class holding properties like field length, field type about a field in the carrier. type: object properties: FieldRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight' FieldType: type: string FieldLength: format: int32 description: '' type: integer SuperOffice.CRM.Security.FieldRight: description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined." type: object properties: Mask: type: string Reason: type: string ```` ## Related topics - [SuperOffice.WebApi.Agents.EMailAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.EMailAgent.md) - [SuperOffice.WebApi.Agents.IEMailAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.IEMailAgent.md) - [Delete E Mail Account](/en/api/reference/restful/agent/email_agent/delete-e-mail-account.md) - [Save E Mail](/en/api/reference/restful/agent/email_agent/save-e-mail.md) - [Get E Mail Account](/en/api/reference/restful/agent/email_agent/get-e-mail-account.md) - [Get E Mail Account From E Mail Address](/en/api/reference/restful/agent/email_agent/get-e-mail-account-from-e-mail-address.md)