[{"data":1,"prerenderedAt":575},["ShallowReactive",2],{"content-query-KTAGLG1ha7":3},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"summary":10,"slug":11,"categories":12,"body":14,"_type":569,"_id":570,"_source":571,"_file":572,"_stem":573,"_extension":574},"/articles/connect-and-manage-partner-apps","articles",false,"","Connect and Manage Partner Apps","Partner apps are tools built by other companies that can connect to your PrepBusiness account. This article explains how to find apps, connect one, choose what it can access, and remove its access later.","Find partner apps, choose account permissions and manage connected apps.","connect-and-manage-partner-apps",[13],"Setting Up",{"type":15,"children":16,"toc":555},"root",[17,24,37,44,78,84,123,135,141,235,240,247,265,271,276,282,294,300,328,356,361,441,446,451,456,462,492,504,509,514,520],{"type":18,"tag":19,"props":20,"children":21},"element","p",{},[22],{"type":23,"value":9},"text",{"type":18,"tag":19,"props":25,"children":26},{},[27,29,35],{"type":23,"value":28},"Partner integrations are being rolled out gradually. If you don't see ",{"type":18,"tag":30,"props":31,"children":32},"strong",{},[33],{"type":23,"value":34},"Integrations",{"type":23,"value":36}," in your sidebar, the feature isn't available on your account yet.",{"type":18,"tag":38,"props":39,"children":41},"h2",{"id":40},"who-can-do-what",[42],{"type":23,"value":43},"Who Can Do What",{"type":18,"tag":45,"props":46,"children":47},"ul",{},[48,59,69],{"type":18,"tag":49,"props":50,"children":51},"li",{},[52,57],{"type":18,"tag":30,"props":53,"children":54},{},[55],{"type":23,"value":56},"Anyone on your team",{"type":23,"value":58}," can browse the apps on the Integrations page.",{"type":18,"tag":49,"props":60,"children":61},{},[62,67],{"type":18,"tag":30,"props":63,"children":64},{},[65],{"type":23,"value":66},"Only an Owner",{"type":23,"value":68}," can give an app access to an account, and only to accounts they own. This applies to both warehouse (service provider) owners and client (merchant) owners.",{"type":18,"tag":49,"props":70,"children":71},{},[72,76],{"type":18,"tag":30,"props":73,"children":74},{},[75],{"type":23,"value":66},{"type":23,"value":77}," can see and remove the apps connected to an account.",{"type":18,"tag":38,"props":79,"children":81},{"id":80},"finding-apps",[82],{"type":23,"value":83},"Finding Apps",{"type":18,"tag":85,"props":86,"children":87},"ol",{},[88,99,111],{"type":18,"tag":49,"props":89,"children":90},{},[91,93,97],{"type":23,"value":92},"Click ",{"type":18,"tag":30,"props":94,"children":95},{},[96],{"type":23,"value":34},{"type":23,"value":98}," in the sidebar.",{"type":18,"tag":49,"props":100,"children":101},{},[102,104,109],{"type":23,"value":103},"Browse the apps. Each one shows its name and description, plus a ",{"type":18,"tag":30,"props":105,"children":106},{},[107],{"type":23,"value":108},"Website",{"type":23,"value":110}," link if the app's developer has added one.",{"type":18,"tag":49,"props":112,"children":113},{},[114,116,121],{"type":23,"value":115},"If you are an Owner, apps already connected to the account you are using are marked ",{"type":18,"tag":30,"props":117,"children":118},{},[119],{"type":23,"value":120},"Connected",{"type":23,"value":122},".",{"type":18,"tag":19,"props":124,"children":125},{},[126,128,133],{"type":23,"value":127},"If an app's ",{"type":18,"tag":30,"props":129,"children":130},{},[131],{"type":23,"value":132},"Connect",{"type":23,"value":134}," button is greyed out with \"This app can't be connected from here yet\", the app's developer hasn't set up a connection link. Contact the app's developer.",{"type":18,"tag":38,"props":136,"children":138},{"id":137},"connecting-an-app",[139],{"type":23,"value":140},"Connecting an App",{"type":18,"tag":85,"props":142,"children":143},{},[144,155,160,178,183,201,217],{"type":18,"tag":49,"props":145,"children":146},{},[147,149,153],{"type":23,"value":148},"On the Integrations page, click ",{"type":18,"tag":30,"props":150,"children":151},{},[152],{"type":23,"value":132},{"type":23,"value":154}," on the app. This takes you to the app's own website to set it up there.",{"type":18,"tag":49,"props":156,"children":157},{},[158],{"type":23,"value":159},"When the app asks for access, you are brought back to PrepBusiness. Log in if you're asked to.",{"type":18,"tag":49,"props":161,"children":162},{},[163,165,170,172,177],{"type":23,"value":164},"Review the request. The page shows which app is asking and lists the accounts you own, grouped under ",{"type":18,"tag":30,"props":166,"children":167},{},[168],{"type":23,"value":169},"Service providers",{"type":23,"value":171}," and ",{"type":18,"tag":30,"props":173,"children":174},{},[175],{"type":23,"value":176},"Merchants",{"type":23,"value":122},{"type":18,"tag":49,"props":179,"children":180},{},[181],{"type":23,"value":182},"Tick each account you want the app to use.",{"type":18,"tag":49,"props":184,"children":185},{},[186,188,199],{"type":23,"value":187},"For each ticked account, choose a permission from ",{"type":18,"tag":30,"props":189,"children":190},{},[191,193],{"type":23,"value":192},"Add a permission for ",{"type":18,"tag":194,"props":195,"children":196},"span",{},[197],{"type":23,"value":198},"account",{"type":23,"value":200},". Repeat until you've added every permission you want to give. Nothing is selected for you, and each ticked account needs at least one permission.",{"type":18,"tag":49,"props":202,"children":203},{},[204,206,216],{"type":23,"value":205},"Check the summary under ",{"type":18,"tag":30,"props":207,"children":208},{},[209,211],{"type":23,"value":210},"Approving will grant ",{"type":18,"tag":194,"props":212,"children":213},{},[214],{"type":23,"value":215},"app",{"type":23,"value":122},{"type":18,"tag":49,"props":218,"children":219},{},[220,221,226,228,233],{"type":23,"value":92},{"type":18,"tag":30,"props":222,"children":223},{},[224],{"type":23,"value":225},"Approve",{"type":23,"value":227}," to connect, or ",{"type":18,"tag":30,"props":229,"children":230},{},[231],{"type":23,"value":232},"Deny",{"type":23,"value":234}," to refuse. Either way you are returned to the app.",{"type":18,"tag":19,"props":236,"children":237},{},[238],{"type":23,"value":239},"Some apps can also start this from their own website without going through the Integrations page. The steps from step 2 on are the same.",{"type":18,"tag":241,"props":242,"children":244},"h3",{"id":243},"about-permissions",[245],{"type":23,"value":246},"About Permissions",{"type":18,"tag":45,"props":248,"children":249},{},[250,255,260],{"type":18,"tag":49,"props":251,"children":252},{},[253],{"type":23,"value":254},"You only see permissions the app asked for, and you can give each account a different set.",{"type":18,"tag":49,"props":256,"children":257},{},[258],{"type":23,"value":259},"Each permission is separate. For example, \"Update inventory\" does not include \"View inventory\".",{"type":18,"tag":49,"props":261,"children":262},{},[263],{"type":23,"value":264},"A permission lets the app request that kind of access. It doesn't guarantee the app can already do everything that permission describes. Ask the app's developer what their app does.",{"type":18,"tag":241,"props":266,"children":268},{"id":267},"if-you-see-no-accounts-available",[269],{"type":23,"value":270},"If You See \"No accounts available\"",{"type":18,"tag":19,"props":272,"children":273},{},[274],{"type":23,"value":275},"Only account Owners can approve apps. Ask an Owner of the account to connect the app.",{"type":18,"tag":241,"props":277,"children":279},{"id":278},"connecting-the-same-app-again",[280],{"type":23,"value":281},"Connecting the Same App Again",{"type":18,"tag":19,"props":283,"children":284},{},[285,287,292],{"type":23,"value":286},"If you connect an app you've already connected, the accounts and permissions you choose this time ",{"type":18,"tag":30,"props":288,"children":289},{},[290],{"type":23,"value":291},"replace",{"type":23,"value":293}," your earlier choices for that app. Any account you don't tick again loses access.",{"type":18,"tag":38,"props":295,"children":297},{"id":296},"reviewing-connected-apps",[298],{"type":23,"value":299},"Reviewing Connected Apps",{"type":18,"tag":19,"props":301,"children":302},{},[303,308,310,315,317,321,322,327],{"type":18,"tag":30,"props":304,"children":305},{},[306],{"type":23,"value":307},"Warehouses (service providers):",{"type":23,"value":309}," go to ",{"type":18,"tag":30,"props":311,"children":312},{},[313],{"type":23,"value":314},"Account Settings",{"type":23,"value":316}," → ",{"type":18,"tag":30,"props":318,"children":319},{},[320],{"type":23,"value":34},{"type":23,"value":316},{"type":18,"tag":30,"props":323,"children":324},{},[325],{"type":23,"value":326},"Connected Apps",{"type":23,"value":122},{"type":18,"tag":19,"props":329,"children":330},{},[331,336,337,342,343,347,349,354],{"type":18,"tag":30,"props":332,"children":333},{},[334],{"type":23,"value":335},"Clients (merchants):",{"type":23,"value":309},{"type":18,"tag":30,"props":338,"children":339},{},[340],{"type":23,"value":341},"Merchant Settings",{"type":23,"value":316},{"type":18,"tag":30,"props":344,"children":345},{},[346],{"type":23,"value":34},{"type":23,"value":348}," and scroll to ",{"type":18,"tag":30,"props":350,"children":351},{},[352],{"type":23,"value":353},"Connected apps",{"type":23,"value":355}," below your webhooks.",{"type":18,"tag":19,"props":357,"children":358},{},[359],{"type":23,"value":360},"The list shows each app, the permissions it has for this account, its status and the date it was connected.",{"type":18,"tag":362,"props":363,"children":364},"table",{},[365,384],{"type":18,"tag":366,"props":367,"children":368},"thead",{},[369],{"type":18,"tag":370,"props":371,"children":372},"tr",{},[373,379],{"type":18,"tag":374,"props":375,"children":376},"th",{},[377],{"type":23,"value":378},"Status",{"type":18,"tag":374,"props":380,"children":381},{},[382],{"type":23,"value":383},"What it means",{"type":18,"tag":385,"props":386,"children":387},"tbody",{},[388,402,415,428],{"type":18,"tag":370,"props":389,"children":390},{},[391,397],{"type":18,"tag":392,"props":393,"children":394},"td",{},[395],{"type":23,"value":396},"Active",{"type":18,"tag":392,"props":398,"children":399},{},[400],{"type":23,"value":401},"The app can use its access.",{"type":18,"tag":370,"props":403,"children":404},{},[405,410],{"type":18,"tag":392,"props":406,"children":407},{},[408],{"type":23,"value":409},"Not approved",{"type":18,"tag":392,"props":411,"children":412},{},[413],{"type":23,"value":414},"The app isn't approved right now, so it can't use its access until it is.",{"type":18,"tag":370,"props":416,"children":417},{},[418,423],{"type":18,"tag":392,"props":419,"children":420},{},[421],{"type":23,"value":422},"Suspended",{"type":18,"tag":392,"props":424,"children":425},{},[426],{"type":23,"value":427},"The app is suspended, so it can't use its access until it's reinstated.",{"type":18,"tag":370,"props":429,"children":430},{},[431,436],{"type":18,"tag":392,"props":432,"children":433},{},[434],{"type":23,"value":435},"Revoked",{"type":18,"tag":392,"props":437,"children":438},{},[439],{"type":23,"value":440},"The app was revoked and can no longer use its access.",{"type":18,"tag":19,"props":442,"children":443},{},[444],{"type":23,"value":445},"You can still remove an app whatever its status.",{"type":18,"tag":19,"props":447,"children":448},{},[449],{"type":23,"value":450},"If two Owners each connected the same app, it appears once for each of them.",{"type":18,"tag":19,"props":452,"children":453},{},[454],{"type":23,"value":455},"Owning a warehouse doesn't let you manage your clients' connected apps. Each account's connected apps are managed by that account's own Owners.",{"type":18,"tag":38,"props":457,"children":459},{"id":458},"removing-an-app",[460],{"type":23,"value":461},"Removing an App",{"type":18,"tag":85,"props":463,"children":464},{},[465,470,481],{"type":18,"tag":49,"props":466,"children":467},{},[468],{"type":23,"value":469},"Open the connected apps list for the account (see above).",{"type":18,"tag":49,"props":471,"children":472},{},[473,474,479],{"type":23,"value":92},{"type":18,"tag":30,"props":475,"children":476},{},[477],{"type":23,"value":478},"Remove",{"type":23,"value":480}," next to the app.",{"type":18,"tag":49,"props":482,"children":483},{},[484,485,490],{"type":23,"value":92},{"type":18,"tag":30,"props":486,"children":487},{},[488],{"type":23,"value":489},"Remove app",{"type":23,"value":491}," to confirm.",{"type":18,"tag":19,"props":493,"children":494},{},[495,497,502],{"type":23,"value":496},"The app immediately loses access to ",{"type":18,"tag":30,"props":498,"children":499},{},[500],{"type":23,"value":501},"this account only",{"type":23,"value":503},". If you also gave it access to other accounts, those keep working. Remove the app from each account it should no longer reach.",{"type":18,"tag":19,"props":505,"children":506},{},[507],{"type":23,"value":508},"When an app has been removed from every account it was given, it is fully disconnected. To use it again, you need to connect it and approve it again.",{"type":18,"tag":19,"props":510,"children":511},{},[512],{"type":23,"value":513},"Removing a team member or changing their role does not disconnect apps they approved. Remove those apps from the connected apps list.",{"type":18,"tag":38,"props":515,"children":517},{"id":516},"related-articles",[518],{"type":23,"value":519},"Related Articles",{"type":18,"tag":45,"props":521,"children":522},{},[523,535,545],{"type":18,"tag":49,"props":524,"children":525},{},[526],{"type":18,"tag":527,"props":528,"children":532},"a",{"href":529,"rel":530},"https://help.prepbusiness.com/articles/user-roles-permissions",[531],"nofollow",[533],{"type":23,"value":534},"User Roles & Permissions",{"type":18,"tag":49,"props":536,"children":537},{},[538],{"type":18,"tag":527,"props":539,"children":542},{"href":540,"rel":541},"https://help.prepbusiness.com/articles/prepbusiness-api",[531],[543],{"type":23,"value":544},"PrepBusiness API",{"type":18,"tag":49,"props":546,"children":547},{},[548],{"type":18,"tag":527,"props":549,"children":552},{"href":550,"rel":551},"https://help.prepbusiness.com/articles/configuring-webhooks",[531],[553],{"type":23,"value":554},"Configuring Webhooks",{"title":7,"searchDepth":556,"depth":556,"links":557},2,[558,559,560,566,567,568],{"id":40,"depth":556,"text":43},{"id":80,"depth":556,"text":83},{"id":137,"depth":556,"text":140,"children":561},[562,564,565],{"id":243,"depth":563,"text":246},3,{"id":267,"depth":563,"text":270},{"id":278,"depth":563,"text":281},{"id":296,"depth":556,"text":299},{"id":458,"depth":556,"text":461},{"id":516,"depth":556,"text":519},"markdown","content:articles:connect-and-manage-partner-apps.md","content","articles/connect-and-manage-partner-apps.md","articles/connect-and-manage-partner-apps","md",1793077420243]