{"id":987522415,"date":"2026-01-29T11:19:44","date_gmt":"2026-01-29T11:19:44","guid":{"rendered":"https:\/\/www.teamogy.com\/?p=987522415"},"modified":"2026-01-29T11:19:47","modified_gmt":"2026-01-29T11:19:47","slug":"programmatic-user-secure-api-access-in-teamogy","status":"publish","type":"post","link":"https:\/\/www.teamogy.com\/es\/manual\/programmatic-user-secure-api-access-in-teamogy\/","title":{"rendered":"Programmatic User \u2013 Secure API Access in Teamogy"},"content":{"rendered":"

[et_pb_section fb_built=\u00bb1″ _builder_version=\u00bb4.16″ global_colors_info=\u00bb{}\u00bb][et_pb_row column_structure=\u00bb3_4,1_4″ module_class=\u00bb et_pb_row_fullwidth\u00bb _builder_version=\u00bb4.16″ width=\u00bb89%\u00bb width_tablet=\u00bb80%\u00bb width_phone=\u00bb\u00bb width_last_edited=\u00bbon|desktop\u00bb max_width=\u00bb89%\u00bb max_width_tablet=\u00bb80%\u00bb max_width_phone=\u00bb\u00bb max_width_last_edited=\u00bbon|desktop\u00bb custom_padding=\u00bb27px|0px|0|0|false|false\u00bb make_fullwidth=\u00bbon\u00bb global_colors_info=\u00bb{}\u00bb][et_pb_column type=\u00bb3_4″ _builder_version=\u00bb4.16″ custom_padding=\u00bb|||\u00bb global_colors_info=\u00bb{}\u00bb custom_padding__hover=\u00bb|||\u00bb][et_pb_text _builder_version=\u00bb4.25.1″ custom_margin=\u00bb|40px|40px|||\u00bb custom_padding=\u00bb||2px|||\u00bb global_colors_info=\u00bb{}\u00bb]<\/p>\n

Programmatic User \u2013 a Secure way to Work with the API<\/h2>\n

[\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ custom_margin=\u00bb|40px|33px|||\u00bb hover_enabled=\u00bb0″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

Programmatic User and API Access<\/h5>\n

[\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ text_font=\u00bb|300|||||||\u00bb ul_font=\u00bb||||||||\u00bb custom_margin=\u00bb|40px|40px|||\u00bb hover_enabled=\u00bb0″ ul_text_shadow_style=\u00bbpreset3″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

External system integrations with Teamogy are implemented using the Teamogy API.
Access to the API is secured via an API token (API key).<\/strong><\/p>\n

Each API token is always associated with a specific user in Teamogy and inherits all permissions assigned to that user.<\/strong>
From the system perspective, all API operations are processed in the same way as actions performed manually by the associated user in the Teamogy application.<\/p>\n

For this reason, the choice of the user under which the API token is generated is critical.<\/strong><\/p>\n

[\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ custom_margin=\u00bb|40px|32px|||\u00bb hover_enabled=\u00bb0″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

\n
\n
\n
\n
Why not use a Personal User Account<\/h5>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
<\/div>\n<\/div>\n<\/div>\n<\/div>\n

[\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ text_font=\u00bb|300|||||||\u00bb ul_font=\u00bb||||||||\u00bb min_height=\u00bb71px\u00bb custom_margin=\u00bb|40px|9px|||\u00bb hover_enabled=\u00bb0″ ul_text_shadow_style=\u00bbpreset3″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

API tokens inherit the full permission set of the user they are linked to.
Therefore, personal user accounts<\/strong> (e.g. company owners, accountants, administrators) are not suitable <\/strong>for API integrations.<\/strong><\/p>\n

Using a personal user account for API access introduces the following risks:<\/strong><\/p>\n

    \n
  1. The API token inherits permissions<\/strong> that are often broader than required for the integration.<\/li>\n
  2. The token holder (for example, an external developer or integration provider) may gain access to all data<\/strong> available to the personal user account.<\/li>\n
  3. System activity is no longer clearly distinguishable between actions performed<\/strong> by a human user and actions executed by an automated integration.<\/li>\n
  4. Token management<\/strong> becomes complex in cases such as role changes, user deactivation, or security incidents.<\/li>\n<\/ol>\n

    For security and operational reasons, the use of personal user accounts for API integrations is strongly discouraged.<\/strong>
    Personal user accounts are not intended for API communication.<\/strong><\/p>\n

    [\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ custom_margin=\u00bb30px|40px|33px|||\u00bb custom_padding=\u00bb0px|||||\u00bb hover_enabled=\u00bb0″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

    \n
    \n
    \n
    \n
    Recommended Approach: Programmatic user<\/h5>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n

    [\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ text_font=\u00bb|300|||||||\u00bb ul_font=\u00bb||||||||\u00bb custom_margin=\u00bb|40px|40px|||\u00bb hover_enabled=\u00bb0″ ul_text_shadow_style=\u00bbpreset3″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″]<\/p>\n

    Teamogy therefore supports the use of a Programmatic User.<\/strong><\/p>\n

    A programmatic user is a dedicated technical account intended exclusively for API access and system integrations.<\/strong><\/p>\n

    Characteristics of a Programmatic User<\/strong><\/p>\n

      \n
    1. Fully separated<\/strong> from personal user accounts.<\/li>\n
    2. Hidden<\/strong> from standard Teamogy usage (not available in user selections, lists, or overviews).<\/li>\n
    3. Assigned explicitly defined permissions<\/strong> limited to the scope required by the integration.<\/li>\n
    4. API tokens<\/strong> generated under a programmatic user are<\/strong> easy to manage, control, and audit.<\/strong><\/li>\n<\/ol>\n

      This approach follows the principle of least privilege:<\/strong><\/p>\n

      An integration should be granted only the permissions necessary for its intended functionality.<\/p>\n

      [\/et_pb_text][et_pb_text _builder_version=\u00bb4.27.5″ text_font=\u00bb|300|||||||\u00bb ul_font=\u00bb||||||||\u00bb custom_margin=\u00bb|40px|40px|||\u00bb hover_enabled=\u00bb0″ ul_text_shadow_style=\u00bbpreset3″ global_colors_info=\u00bb{}\u00bb sticky_enabled=\u00bb0″ custom_padding=\u00bb||0px|||\u00bb]<\/p>\n

      Click to read more<\/strong> – How to create a Programmatic user<\/a><\/span><\/p>\n

      [\/et_pb_text][et_pb_text _builder_version=\u00bb3.26.5″ text_font=\u00bb|300|||||||\u00bb custom_margin=\u00bb-14px|40px||||\u00bb custom_padding=\u00bb12px|0px||||\u00bb text_font_last_edited=\u00bboff|desktop\u00bb global_module=\u00bb14686″ saved_tabs=\u00bball\u00bb global_colors_info=\u00bb{}\u00bb]<\/p>\n

      Get in Touch<\/b><\/span><\/p>\n

      If you have problem or need further assistance, do not hesitate contact Teamogy Support. Use online chat (inside Teamogy or everywhere on\u00a0www.Teamogy.com<\/a><\/span> in the lower right corner) and you will get prompt reply.<\/span><\/p>\n

      [\/et_pb_text][\/et_pb_column][et_pb_column type=\u00bb1_4″ _builder_version=\u00bb4.16″ custom_padding=\u00bb|||\u00bb global_colors_info=\u00bb{}\u00bb custom_padding__hover=\u00bb|||\u00bb][et_pb_sidebar area=\u00bbet_pb_widget_area_1″ _builder_version=\u00bb4.16″ header_font=\u00bb||||||||\u00bb header_font_size=\u00bb30px\u00bb body_font=\u00bb||||||||\u00bb body_font_size=\u00bb14px\u00bb body_line_height=\u00bb1.6em\u00bb global_colors_info=\u00bb{}\u00bb][\/et_pb_sidebar][\/et_pb_column][\/et_pb_row][\/et_pb_section]<\/p>\n","protected":false},"excerpt":{"rendered":"

      Programmatic User \u2013 a Secure way to Work with the APIProgrammatic User and API AccessExternal system integrations with Teamogy are implemented using the Teamogy API.Access to the API is secured via an API token (API key). Each API token is always associated with a specific user in Teamogy and inherits all permissions assigned to that […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[291],"tags":[],"class_list":["post-987522415","post","type-post","status-publish","format-standard","hentry","category-manual"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/posts\/987522415","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/comments?post=987522415"}],"version-history":[{"count":5,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/posts\/987522415\/revisions"}],"predecessor-version":[{"id":987522431,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/posts\/987522415\/revisions\/987522431"}],"wp:attachment":[{"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/media?parent=987522415"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/categories?post=987522415"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.teamogy.com\/es\/wp-json\/wp\/v2\/tags?post=987522415"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}