> ## 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. # Post Foreign App_ P U T > Creates a new ForeignApp Calls the ForeignSystem agent service SaveForeignAppEntity. ## OpenAPI ````yaml /openapi/rest/openapi-v3-ForeignApp.json put /api/v1/ForeignApp/{appName} openapi: 3.0.0 info: version: v1-REST title: SuperOffice REST API v1 description: SuperOffice REST API - ForeignApp 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/ForeignApp/{appName}: put: tags: - ForeignApp summary: Post Foreign App_ P U T description: |- Creates a new ForeignApp Calls the ForeignSystem agent service SaveForeignAppEntity. operationId: v1ForeignAppEntity_PostForeignApp_PUT parameters: - name: appName in: path description: The ForeignApp to be saved. required: true schema: type: string - 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 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignAppEntity' security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.CRM.Services.ForeignAppEntity: description: "Carrier object for ForeignAppEntity.\r\nServices for the ForeignAppEntity Carrier is available from the ForeignSystem Agent." type: object properties: ForeignAppId: format: int32 description: Primary key type: integer Name: description: Name of foreign application type: string CreatedDate: format: date-time description: Registered when in UTC. type: string UpdatedDate: format: date-time description: Last updated when in UTC. type: string CreatedBy: $ref: '#/components/schemas/SuperOffice.CRM.Services.Associate' UpdatedBy: $ref: '#/components/schemas/SuperOffice.CRM.Services.Associate' Devices: description: The devices that belong to this foreign app. type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.ForeignDevice' 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.Associate: description: "Carrier object for Associate.\r\nServices for the Associate Carrier is available from the Associate Agent." type: object properties: AssociateId: format: int32 description: Primary key type: integer Name: description: Initials, also login name, possibly database user name type: string PersonId: format: int32 description: "Owning person record \r\nUse MDO List name \"person\" to get list items." type: integer Rank: format: int32 description: Rank order type: integer Tooltip: description: Tooltip or other description type: string Type: description: >- User type - 1 = internal user, 2 = resource, 3 = external user, 4 = anonymous, 5 = system enum: - Unknown - InternalAssociate - ResourceAssociate - ExternalAssociate - AnonymousAssociate - SystemAssociate type: string GroupIdx: format: int32 description: >- Primary group membership, see UserGroupLink for secondary memberships type: integer FullName: description: >- The associate's culture formatted fullname (firstname, middleName and lastname) type: string FormalName: description: >- The associate's culture formatted formalname (firstname, middleName and lastname, title, mrmrs) type: string Deleted: description: >- If true, the user is retired and should have no rights, not appear in lists, etc. type: boolean EjUserId: format: int32 description: >- ID of the ej user record corresponding to this associate; 0 for associates that are not ej users type: integer UserName: description: User name type: string ExtraFields: description: "Deprecated: Use {SuperOffice.CRM.Services.Associate.CustomFields} instead.\r\nExtra fields added to the carrier. This could be data from Plug-ins, the foreign key system, external applications, etc." type: object additionalProperties: type: string CustomFields: description: "Udef + Extra fields added to the carrier. Extra fields as defined by changes to database schema + user-defined fields as defined by admin.\r\nCustom fields combines user defined fields and extra fields into one bucket. \r\nThe individual {SuperOffice.CRM.Services.Associate.ExtraFields} and UserDefinedFields properties are deprecated in favor of this\r\ncombined collection." type: object additionalProperties: 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.Services.ForeignDevice: description: "Saves a foreign device belonging to the ForeignDevice and application name specified.\r\n\r\nCarrier object for ForeignDevice.\r\nServices for the ForeignDevice Carrier is available from the ForeignSystem Agent." type: object properties: ForeignDeviceId: format: int32 description: Primary key type: integer Name: description: Name of device type: string CreatedDate: format: date-time description: Registered when in UTC. type: string UpdatedDate: format: date-time description: Last updated when in UTC. type: string AssociateFullName: description: The person owning the Foreign Device type: string CreatedBy: description: The person that created the device. type: string UpdatedBy: description: The person that last updated this device. type: string DeviceIdentifier: description: Optional unique id of device (Palm pilot device ID, etc) type: string ForeignAppId: format: int32 description: Reference to foregin application (device type) 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.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 - [Post Foreign App](/en/api/reference/restful/rest/foreignapp/post-foreign-app.md) - [Post Foreign App Entity](/en/api/reference/restful/rest/foreignapp/post-foreign-app-entity.md) - [Delete Foreign App Entity](/en/api/reference/restful/agent/foreignsystem_agent/delete-foreign-app-entity.md) - [Foreign keys](/en/api/foreign-keys/index.md) - [Get Foreign App Entity](/en/api/reference/restful/rest/foreignapp/get-foreign-app-entity.md)