POST v2/apps/{appId}/tenants

Create a Tenant inside the master app, NOTE Leave the footer empty to replicate master footer.

Request Information

URI Parameters

Name Type Description
appId integer
Additional Info :

Required

Body Parameters

TenantCreateRequest
Name Type Description
AppId integer

Application Id this tenant belongs to

Additional Info :

Required
DisplayName string

Name displayed in Application

Additional Info :

Required
IconUrl string

Url to the Icon/Avatar to display in the Application
SplashUrl string

Url to the Splash Image for the Tenant, displayed when it is the chosen tenant
Url string

Url of the Site for the Tenant to load on start up. Must be a full absolute url including the http or https scheme

Additional Info :

Required
Disabled boolean

True if the Tenant is disabled, the application will behave as if it is deleted
Hidden boolean

If true, the tenant will not be displayed in the application, but can still be used or switched to using a deep link
DisplayOrder integer

Relative number to specify the order the Tenant is displayed in the listing
Description string

Description of the tenant app
FirstName string

First name of the owner or person responsible for the tenant app

Additional Info :

Required

Length between 0 and 50
LastName string

Last Name of the owner or person responsible for the tenant app

Additional Info :

Required

Length between 0 and 50
Phone string

Phone number of the owner or person responsible for the tenant app

Additional Info :

Length between 0 and 50
SupportEmail string

Email address of the owner or person responsible for the tenant app

Additional Info :

Length between 0 and 180

Matching: (?i)^[a-z0-9._%+-]+@(?:[a-z0-9][a-z0-9-]*\.)+[a-z]{2,}$
SupportSite string

Optional support url for the tenant app, may be different than the Url
Footer FooterRequest

Optional footer information to use for this tenant
Tag string

Optional associated data for the tenant, for instance a database id of the member its for
SocialDescription string

Social Description used when posting links to social media Maximum string length of 255 any extra will be trimmed.
RollOverId integer

If the tenant gets deleted it will redirect the user to that rollover id
LandingPage HomeRequest

Optional landing page feature data for ionic apps.
FacebookUrl string

Facebook Page Url
TwitterUrl string

Twitter Page Url
LinkedInUrl string

LinkedInUrl Url
GooglePlusUrl string

GooglePlus Page Url
IonicTemplateId string

If the ionic template supports multiple design for the tenant. (Id is based on the template).
Source string

The location of the tenant when it was created.

Request Formats

{
  "appId": 1234,
  "displayName": "Bob's Plumbing",
  "iconUrl": "http://imagehosting.com/AGOEN32SDSAE392DSAJ",
  "splashUrl": "http://imagehosting.com/AOEUHGDEG832KGd",
  "url": "http://bobdoesplumbing.com/",
  "disabled": false,
  "hidden": false,
  "displayOrder": 4,
  "description": null,
  "firstName": null,
  "lastName": null,
  "phone": null,
  "supportEmail": null,
  "supportSite": null,
  "footer": {
    "footerType": 1,
    "footerData": [
      {
        "title": "Home",
        "url": "http://myhomepage.com",
        "image": "glyphicon glyphicon-home",
        "imageCode": null,
        "fColor": "000000",
        "bColor": "ffffff",
        "sTabColor": "ffffff",
        "isBurger": false,
        "type": null
      },
      {
        "title": "Phone",
        "url": "tel:314-433-3222",
        "image": "fa fa-phone-square",
        "imageCode": null,
        "fColor": "000000",
        "bColor": "ffffff",
        "sTabColor": "ffffff",
        "isBurger": false,
        "type": null
      },
      {
        "title": "Push Log",
        "url": "native:pushlog",
        "image": "fa fa-comments-o",
        "imageCode": null,
        "fColor": "000000",
        "bColor": "ffffff",
        "sTabColor": "ffffff",
        "isBurger": false,
        "type": null
      },
      {
        "title": "Email",
        "url": "mailto:support@appnotch.com",
        "image": "glyphicon glyphicon-envelope",
        "imageCode": null,
        "fColor": "000000",
        "bColor": "ffffff",
        "sTabColor": "ffffff",
        "isBurger": false,
        "type": null
      },
      {
        "title": "Social",
        "url": "http://facebook.com/appnotch",
        "image": "glyphicon glyphicon-globe",
        "imageCode": null,
        "fColor": "000000",
        "bColor": "ffffff",
        "sTabColor": "ffffff",
        "isBurger": false,
        "type": null
      }
    ]
  },
  "tag": "My Custom Tag",
  "socialDescription": null,
  "rollOverId": 0,
  "landingPage": null,
  "facebookUrl": null,
  "twitterUrl": null,
  "linkedInUrl": null,
  "googlePlusUrl": null,
  "ionicTemplateId": null,
  "source": "Dashboard"
}

<TenantCreateRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AppNotch.Converter.Api.Server.Models">
  <AppId>1234</AppId>
  <Description i:nil="true" />
  <Disabled>false</Disabled>
  <DisplayName>Bob's Plumbing</DisplayName>
  <DisplayOrder>4</DisplayOrder>
  <FacebookUrl i:nil="true" />
  <FirstName i:nil="true" />
  <Footer>
    <FooterData>
      <FooterItem>
        <BColor>ffffff</BColor>
        <FColor>000000</FColor>
        <Image>glyphicon glyphicon-home</Image>
        <ImageCode i:nil="true" />
        <IsBurger>false</IsBurger>
        <STabColor>ffffff</STabColor>
        <Title>Home</Title>
        <Type i:nil="true" />
        <Url>http://myhomepage.com</Url>
      </FooterItem>
      <FooterItem>
        <BColor>ffffff</BColor>
        <FColor>000000</FColor>
        <Image>fa fa-phone-square</Image>
        <ImageCode i:nil="true" />
        <IsBurger>false</IsBurger>
        <STabColor>ffffff</STabColor>
        <Title>Phone</Title>
        <Type i:nil="true" />
        <Url>tel:314-433-3222</Url>
      </FooterItem>
      <FooterItem>
        <BColor>ffffff</BColor>
        <FColor>000000</FColor>
        <Image>fa fa-comments-o</Image>
        <ImageCode i:nil="true" />
        <IsBurger>false</IsBurger>
        <STabColor>ffffff</STabColor>
        <Title>Push Log</Title>
        <Type i:nil="true" />
        <Url>native:pushlog</Url>
      </FooterItem>
      <FooterItem>
        <BColor>ffffff</BColor>
        <FColor>000000</FColor>
        <Image>glyphicon glyphicon-envelope</Image>
        <ImageCode i:nil="true" />
        <IsBurger>false</IsBurger>
        <STabColor>ffffff</STabColor>
        <Title>Email</Title>
        <Type i:nil="true" />
        <Url>mailto:support@appnotch.com</Url>
      </FooterItem>
      <FooterItem>
        <BColor>ffffff</BColor>
        <FColor>000000</FColor>
        <Image>glyphicon glyphicon-globe</Image>
        <ImageCode i:nil="true" />
        <IsBurger>false</IsBurger>
        <STabColor>ffffff</STabColor>
        <Title>Social</Title>
        <Type i:nil="true" />
        <Url>http://facebook.com/appnotch</Url>
      </FooterItem>
    </FooterData>
    <FooterType>1</FooterType>
  </Footer>
  <GooglePlusUrl i:nil="true" />
  <Hidden>false</Hidden>
  <IconUrl>http://imagehosting.com/AGOEN32SDSAE392DSAJ</IconUrl>
  <IonicTemplateId i:nil="true" />
  <LandingPage i:nil="true" />
  <LastName i:nil="true" />
  <LinkedInUrl i:nil="true" />
  <Phone i:nil="true" />
  <RollOverId>0</RollOverId>
  <SocialDescription i:nil="true" />
  <Source>Dashboard</Source>
  <SplashUrl>http://imagehosting.com/AOEUHGDEG832KGd</SplashUrl>
  <SupportEmail i:nil="true" />
  <SupportSite i:nil="true" />
  <Tag>My Custom Tag</Tag>
  <TwitterUrl i:nil="true" />
  <Url>http://bobdoesplumbing.com/</Url>
</TenantCreateRequest>

Response Information

Resource Description

TenantFullResponse
Name Type Description
FirstName string

First name of the owner or person responsible for the tenant app
LastName string

Last Name of the owner or person responsible for the tenant app
Phone string

Phone number of the owner or person responsible for the tenant app
SupportEmail string

Email address of the owner or person responsible for the tenant app
SupportSite string

Optional support url for the tenant app, may be different than the Url
Footer FooterResponse

Footer to be displayed if chosen (separate from master app)
Home HomeResponse

Home to be displayed if chosen
Tag string

Associated data for the tenant, for instance a database id of the member its for
SocialDescription string

Social Description used when posting links to social media Maximum string length of 255 any extra will be trimmed.
Id integer

Id of the Tenant
AppId integer

Application Id this tenant belongs to
DisplayName string

Name displayed in Application
IconUrl string

Url to the Icon/Avatar to display in the Application
SplashUrl string

Url to the Splash Image for the Tenant, displayed when it is the chosen tenant
Url string

Url of the Site for the Tenant to load on start up
Disabled boolean

True if the Tenant is disabled, won't be sent to the Application. Users with this Tenant Selected will revert to Master App
Hidden boolean

Not Displayed in List, but Available for use
DisplayOrder integer

Relative number to specify the order the Tenant is displayed in the listing
CreateDate date

Date the Tenant was created
FooterUrl string

Url of the Footer for the tenant
ShareContent string

Content to be used when the 'Share' button is tapped within the app. If null or empty the share button will be hidden. Typically this is the BranchUrl
BranchUrl string

Url for the Branch Deep link to open the app to this tenant
Description string

Description of the tenant app
FacebookLink string

Social Media Link : Facebook
TwitterLink string

Social Media Link : Twitter
LinkedInLink string

Social Media Link : Linked In
GooglePlus string

Social Media Link : Google+
IonicTemplateId string

If the ionic template supports multiple design for the tenant. (Id is based on the template).
Source string

The location of the tenant when it was created.
Category string

Category of the tenant

Response Formats

{
  "firstName": null,
  "lastName": null,
  "phone": null,
  "supportEmail": null,
  "supportSite": null,
  "footer": null,
  "home": null,
  "tag": "My Custom Tag",
  "socialDescription": null,
  "id": 412,
  "appId": 1234,
  "displayName": "Bob's Plumbing",
  "iconUrl": "http://imagehosting.com/AGOEN32SDSAE392DSAJ",
  "splashUrl": "http://imagehosting.com/AOEUHGDEG832KGd",
  "url": "http://bobdoesplumbing.com",
  "disabled": false,
  "hidden": false,
  "displayOrder": 4,
  "createDate": "2024-10-20T15:39:30.3534203Z",
  "footerUrl": "http://app.appnotch.com/converter/footer/tenant/412",
  "shareContent": "https://a2bc.app.link/ag7GFe26dE",
  "branchUrl": "https://a2bc.app.link/ag7GFe26dE",
  "description": "Hi, My Name is Bob, I have a small plumbing company based in Chicago, We service the south Central area, but always would love to help if you do not reside there. We provide all sorts of services for Residential and Commercial Properties. Request an free estimate appointment using this app!",
  "facebookLink": null,
  "twitterLink": null,
  "linkedInLink": null,
  "googlePlus": null,
  "ionicTemplateId": null,
  "source": null,
  "category": null
}

<TenantFullResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AppNotch.Converter.Api.Server.Models">
  <AppId>1234</AppId>
  <BranchUrl>https://a2bc.app.link/ag7GFe26dE</BranchUrl>
  <Category i:nil="true" />
  <CreateDate>2024-10-20T15:39:30.3534203+00:00</CreateDate>
  <Description>Hi, My Name is Bob, I have a small plumbing company based in Chicago, We service the south Central area, but always would love to help if you do not reside there. We provide all sorts of services for Residential and Commercial Properties. Request an free estimate appointment using this app!</Description>
  <Disabled>false</Disabled>
  <DisplayName>Bob's Plumbing</DisplayName>
  <DisplayOrder>4</DisplayOrder>
  <FacebookLink i:nil="true" />
  <FooterUrl>http://app.appnotch.com/converter/footer/tenant/412</FooterUrl>
  <GooglePlus i:nil="true" />
  <Hidden>false</Hidden>
  <IconUrl>http://imagehosting.com/AGOEN32SDSAE392DSAJ</IconUrl>
  <Id>412</Id>
  <IonicTemplateId i:nil="true" />
  <LinkedInLink i:nil="true" />
  <Phone i:nil="true" />
  <ShareContent>https://a2bc.app.link/ag7GFe26dE</ShareContent>
  <Source i:nil="true" />
  <SplashUrl>http://imagehosting.com/AOEUHGDEG832KGd</SplashUrl>
  <SupportEmail i:nil="true" />
  <SupportSite i:nil="true" />
  <TwitterLink i:nil="true" />
  <Url>http://bobdoesplumbing.com</Url>
  <FirstName i:nil="true" />
  <Footer i:nil="true" />
  <Home i:nil="true" />
  <LastName i:nil="true" />
  <Phone i:nil="true" />
  <SocialDescription i:nil="true" />
  <SupportEmail i:nil="true" />
  <SupportSite i:nil="true" />
  <Tag>My Custom Tag</Tag>
</TenantFullResponse>