{"id":45112,"date":"2026-02-19T14:19:58","date_gmt":"2026-02-19T13:19:58","guid":{"rendered":"https:\/\/churchtools.academy\/help\/non-knowledgebase\/uncategorized\/oauth-between-two-churchtools-systems\/"},"modified":"2026-03-17T10:51:00","modified_gmt":"2026-03-17T09:51:00","password":"","slug":"oauth-between-two-churchtools-systems","status":"publish","type":"docs","link":"https:\/\/churchtools.academy\/en\/help\/system-settings\/oauth-login-systemsettings\/oauth-between-two-churchtools-systems\/","title":{"rendered":"OAuth between two ChurchTools systems"},"content":{"rendered":"\n<p>In this guide, we will show you how to link two ChurchTools systems together. One of the two systems serves as an authentication server for the other system, the client. This means that users of the server system can then sign up to the client system. They do not need separate login data on the client.   <\/p>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">You can also use this page as an aid if you do not want to use a second ChurchTools but a third-party system. For example, you could use your ChurchTools as an authentication server for a system such as NextCloud or connect another authentication server for your ChurchTools. The respective configuration in ChurchTools remains the same.<br>Unfortunately, we cannot provide you with instructions for the other system. Please refer to the help services of the respective software.   <\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">1. Prepare the OAuth server<\/h2>\n\n\n\n<p>Let&#8217;s first look at how to add a client to your OAuth server. In the ChurchTools system, navigate to the <em>Login page<\/em> that will serve as the server. This is the system on which the users who are to be able to sign up to the second system already exist. We describe how to access the login page at <a href=\"https:\/\/churchtools.academy\/en\/help\/system-settings\/login-en\/login-to-and-with-churchtools\/\" target=\"_blank\" rel=\"noreferrer noopener\">Login to and with ChurchTools<\/a>.<\/p>\n\n\n\n<p>Click on the <strong>Add OAuth client<\/strong> button. A window opens in which you must give the client a name. You can freely choose the name, it only serves as a unique identifier on the server. In our example, it is called &#8220;ChuToo Client&#8221;.   <\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"930\" height=\"382\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client.png\" alt=\"System settings - General - Login - Add OAuth-Client\" class=\"wp-image-47182\" style=\"width:624px;height:auto\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client.png 930w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client-300x123.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client-768x315.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client-360x148.png 360w\" sizes=\"(max-width: 930px) 100vw, 930px\" \/><\/a><\/figure>\n\n\n\n<p>ChurchTools now creates all the server information that is relevant for a connection. You can find a simplified explanation of the terms used on our help page   <a href=\"https:\/\/churchtools.academy\/en\/help\/system-settings\/oauth-login-systemeinstellungen\/what-is-oauth-login-to-third-party-systems\/\" data-type=\"docs\" data-id=\"25486\">What is OAuth? (Login to third-party systems) <\/a>.<\/p>\n\n\n\n<p>The redirect URI is of course missing, as it is provided by the client and must then be entered here.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter.png\"><img decoding=\"async\" width=\"1292\" height=\"1058\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter.png\" alt=\"System settings - General - Login - Add OAuth-Client - Client parameter\" class=\"wp-image-47184\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter.png 1292w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter-300x246.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter-1024x839.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter-768x629.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Add-OAuth-Client_Client-parameter-360x295.png 360w\" sizes=\"(max-width: 1292px) 100vw, 1292px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">Note the blue message box. When the systems are connected, you still need to assign the necessary permissions to be able to use the server for authentication. You can find more information on this in section 3.  <\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">2. Configure the OAuth client<\/h2>\n\n\n\n<p>Now switch to your client system and open the Login page there too. Open the following input mask via the <strong>Add OAuth server<\/strong> button. Enter the relevant data from the server here.  <\/p>\n\n\n\n<p>In the lower section of the input mask, you can use the <strong>Create new persons<\/strong> button to define whether persons who do not yet exist on the client are created when they sign up via the server using OAuth. You must then define which <em>person status <\/em>they receive and which <em>department <\/em>and <em>campus <\/em>they are assigned to. <\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server.png\"><img decoding=\"async\" width=\"1296\" height=\"942\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server.png\" alt=\"System settings - General - Login - Edit OAuth server\" class=\"wp-image-47187\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server.png 1296w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server-300x218.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server-1024x744.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server-768x558.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/System-settings_General_Login_Edit-OAuth-server-360x262.png 360w\" sizes=\"(max-width: 1296px) 100vw, 1296px\" \/><\/a><\/figure>\n\n\n\n<p>If it is important for your connection to the authentication server, fill in the <strong>Client secret<\/strong> field. You can freely assign a password here. No client secret is currently required for the connection to a ChurchTools server.  <\/p>\n\n\n\n<p>Finally, copy the <strong>client identifier<\/strong>.<br>Your work on the client is now completed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. Finalize the OAuth server<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Add redirect URI<\/h3>\n\n\n\n<p>To complete the connection between the two ChurchTools systems, enter the redirect URI on the server&#8217;s Login page. Use the <strong>Add redirect URI<\/strong> button to open the corresponding window and enter the link copied from the client here.<br>All the data required for the connection between the server and client has now been entered. <\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Assign necessary permission<\/h3>\n\n\n\n<p>In order for users of your ChurchTools server to be able to sign up to the ChurchTools client via OAuth, you need the permission Log <strong>in to external system via ChurchTools account (Login to External System)<\/strong>. You can find this permission in the <em>rights management<\/em> in the <em>Administration<\/em> section. For more information, please visit our help page <a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/login-bei-churchtools\/\" target=\"_blank\" rel=\"noreferrer noopener\">Logging in to and with ChurchTools<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Login to the client<\/h2>\n\n\n\n<p>The option to log in via the authentication server is now displayed in the client login screen. The standard login for ChurchTools may be hidden and therefore no longer visible. <\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with.png\"><img loading=\"lazy\" decoding=\"async\" width=\"532\" height=\"1052\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with.png\" alt=\"ChurchTools - Log in with\" class=\"wp-image-47190\" style=\"width:343px\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with.png 532w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with-152x300.png 152w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with-518x1024.png 518w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with-259x512.png 259w\" sizes=\"(max-width: 532px) 100vw, 532px\" \/><\/a><\/figure>\n\n\n\n<p>If you select this option, a window will open informing you which login information will be passed on from the server to the client. If you agree, you will be logged in to the client system. <\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with_pass-information.png\"><img loading=\"lazy\" decoding=\"async\" width=\"530\" height=\"706\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with_pass-information.png\" alt=\"ChurchTools - Log in with - pass information\" class=\"wp-image-47192\" style=\"width:388px;height:auto\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with_pass-information.png 530w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with_pass-information-225x300.png 225w, https:\/\/churchtools.academy\/wp-content\/uploads\/2026\/01\/ChurchTools_Log-in-with_pass-information-360x480.png 360w\" sizes=\"(max-width: 530px) 100vw, 530px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">Bear in mind that log in on the client system depends on the settings in the server.<br>If the <em>Create new person<\/em> option is not activated and you do not have an account on the client system, you cannot log in.<br>If the <em>Create new person<\/em> option is activated, a new account will be created for you on the client if you do not already have one. The <em>person status<\/em>, <em>department<\/em> and <em>campus<\/em> depend on the settings in the server. They can be changed afterwards on the client system.  <\/p>\n<\/aside>\n\n\n\n<aside class=\"wp-block-group ct-artikel-zum-weiterlesen has-background is-layout-constrained wp-container-core-group-is-layout-89fd719a wp-block-group-is-layout-constrained\" style=\"border-radius:8px;background-color:#f9fafb;margin-top:24px;margin-bottom:24px;padding-top:32px;padding-right:24px;padding-bottom:32px;padding-left:24px\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Read more<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/login-systemeinstellungen\/login-bei-churchtools\/\">Login to ChurchTools<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/churchtools.academy\/en\/help\/system-settings\/oauth-login-systemeinstellungen\/what-is-oauth-login-to-third-party-systems\/\">What is OAuth? (Login to third-party systems) <\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/churchtools.academy\/de\/help\/system-einstellungen\/oauth-login-systemeinstellungen\/login-bei-drittsystem-nextcloud-einrichten-oauth\/\">Login to third-party system: Set up Nextcloud (OAuth)<\/a><\/li>\n<\/ul>\n<\/aside>\n","protected":false},"excerpt":{"rendered":"<p>In this guide, we will show you how to link two ChurchTools systems together. One of the two systems serves as an authentication server for the other system, the client. This means that users of the server system can then sign up to the client system. They do not need separate login data on the [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[699],"doc_tag":[],"knowledge_base":[425],"class_list":["post-45112","docs","type-docs","status-publish","hentry","doc_category-oauth-login-systemsettings","knowledge_base-system-settings"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","acf":[],"year_month":"2026-05","word_count":581,"total_views":"579","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Victoria Weidemann","author_nicename":"vweidemann","author_url":"https:\/\/churchtools.academy\/en\/author\/vweidemann\/"},"doc_category_info":[{"term_name":"OAuth","term_url":"https:\/\/churchtools.academy\/en\/help\/system-settings\/oauth-login-systemsettings\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"System Settings","term_url":"https:\/\/churchtools.academy\/en\/help\/system-settings\/","term_slug":"system-settings"}],"knowledge_base_slug":["system-settings"],"_links":{"self":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/45112","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=45112"}],"version-history":[{"count":2061,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/45112\/revisions"}],"predecessor-version":[{"id":50144,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/45112\/revisions\/50144"}],"wp:attachment":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=45112"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=45112"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=45112"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=45112"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}