mergepythonclient 2.3.2__py3-none-any.whl → 2.4.0__py3-none-any.whl

merge/resources/knowledgebase/resources/issues/raw_client.py

@@ -0,0 +1,336 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+from json.decoder import JSONDecodeError
+
+from .....core.api_error import ApiError
+from .....core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .....core.datetime_utils import serialize_datetime
+from .....core.http_response import AsyncHttpResponse, HttpResponse
+from .....core.jsonable_encoder import jsonable_encoder
+from .....core.request_options import RequestOptions
+from .....core.unchecked_base_model import construct_type
+from ...types.issue import Issue
+from ...types.paginated_issue_list import PaginatedIssueList
+from .types.issues_list_request_status import IssuesListRequestStatus
+
+
+class RawIssuesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        *,
+        account_token: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        end_date: typing.Optional[str] = None,
+        end_user_organization_name: typing.Optional[str] = None,
+        first_incident_time_after: typing.Optional[dt.datetime] = None,
+        first_incident_time_before: typing.Optional[dt.datetime] = None,
+        include_muted: typing.Optional[str] = None,
+        integration_name: typing.Optional[str] = None,
+        last_incident_time_after: typing.Optional[dt.datetime] = None,
+        last_incident_time_before: typing.Optional[dt.datetime] = None,
+        linked_account_id: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        start_date: typing.Optional[str] = None,
+        status: typing.Optional[IssuesListRequestStatus] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[PaginatedIssueList]:
+        """
+        Gets all issues for Organization.
+
+        Parameters
+        ----------
+        account_token : typing.Optional[str]
+
+        cursor : typing.Optional[str]
+            The pagination cursor value.
+
+        end_date : typing.Optional[str]
+            If included, will only include issues whose most recent action occurred before this time
+
+        end_user_organization_name : typing.Optional[str]
+
+        first_incident_time_after : typing.Optional[dt.datetime]
+            If provided, will only return issues whose first incident time was after this datetime.
+
+        first_incident_time_before : typing.Optional[dt.datetime]
+            If provided, will only return issues whose first incident time was before this datetime.
+
+        include_muted : typing.Optional[str]
+            If true, will include muted issues
+
+        integration_name : typing.Optional[str]
+
+        last_incident_time_after : typing.Optional[dt.datetime]
+            If provided, will only return issues whose last incident time was after this datetime.
+
+        last_incident_time_before : typing.Optional[dt.datetime]
+            If provided, will only return issues whose last incident time was before this datetime.
+
+        linked_account_id : typing.Optional[str]
+            If provided, will only include issues pertaining to the linked account passed in.
+
+        page_size : typing.Optional[int]
+            Number of results to return per page.
+
+        start_date : typing.Optional[str]
+            If included, will only include issues whose most recent action occurred after this time
+
+        status : typing.Optional[IssuesListRequestStatus]
+            Status of the issue. Options: ('ONGOING', 'RESOLVED')
+
+            * `ONGOING` - ONGOING
+            * `RESOLVED` - RESOLVED
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[PaginatedIssueList]
+
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "knowledgebase/v1/issues",
+            method="GET",
+            params={
+                "account_token": account_token,
+                "cursor": cursor,
+                "end_date": end_date,
+                "end_user_organization_name": end_user_organization_name,
+                "first_incident_time_after": serialize_datetime(first_incident_time_after)
+                if first_incident_time_after is not None
+                else None,
+                "first_incident_time_before": serialize_datetime(first_incident_time_before)
+                if first_incident_time_before is not None
+                else None,
+                "include_muted": include_muted,
+                "integration_name": integration_name,
+                "last_incident_time_after": serialize_datetime(last_incident_time_after)
+                if last_incident_time_after is not None
+                else None,
+                "last_incident_time_before": serialize_datetime(last_incident_time_before)
+                if last_incident_time_before is not None
+                else None,
+                "linked_account_id": linked_account_id,
+                "page_size": page_size,
+                "start_date": start_date,
+                "status": status,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    PaginatedIssueList,
+                    construct_type(
+                        type_=PaginatedIssueList,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def retrieve(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[Issue]:
+        """
+        Get a specific issue.
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Issue]
+
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"knowledgebase/v1/issues/{jsonable_encoder(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Issue,
+                    construct_type(
+                        type_=Issue,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawIssuesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        account_token: typing.Optional[str] = None,
+        cursor: typing.Optional[str] = None,
+        end_date: typing.Optional[str] = None,
+        end_user_organization_name: typing.Optional[str] = None,
+        first_incident_time_after: typing.Optional[dt.datetime] = None,
+        first_incident_time_before: typing.Optional[dt.datetime] = None,
+        include_muted: typing.Optional[str] = None,
+        integration_name: typing.Optional[str] = None,
+        last_incident_time_after: typing.Optional[dt.datetime] = None,
+        last_incident_time_before: typing.Optional[dt.datetime] = None,
+        linked_account_id: typing.Optional[str] = None,
+        page_size: typing.Optional[int] = None,
+        start_date: typing.Optional[str] = None,
+        status: typing.Optional[IssuesListRequestStatus] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[PaginatedIssueList]:
+        """
+        Gets all issues for Organization.
+
+        Parameters
+        ----------
+        account_token : typing.Optional[str]
+
+        cursor : typing.Optional[str]
+            The pagination cursor value.
+
+        end_date : typing.Optional[str]
+            If included, will only include issues whose most recent action occurred before this time
+
+        end_user_organization_name : typing.Optional[str]
+
+        first_incident_time_after : typing.Optional[dt.datetime]
+            If provided, will only return issues whose first incident time was after this datetime.
+
+        first_incident_time_before : typing.Optional[dt.datetime]
+            If provided, will only return issues whose first incident time was before this datetime.
+
+        include_muted : typing.Optional[str]
+            If true, will include muted issues
+
+        integration_name : typing.Optional[str]
+
+        last_incident_time_after : typing.Optional[dt.datetime]
+            If provided, will only return issues whose last incident time was after this datetime.
+
+        last_incident_time_before : typing.Optional[dt.datetime]
+            If provided, will only return issues whose last incident time was before this datetime.
+
+        linked_account_id : typing.Optional[str]
+            If provided, will only include issues pertaining to the linked account passed in.
+
+        page_size : typing.Optional[int]
+            Number of results to return per page.
+
+        start_date : typing.Optional[str]
+            If included, will only include issues whose most recent action occurred after this time
+
+        status : typing.Optional[IssuesListRequestStatus]
+            Status of the issue. Options: ('ONGOING', 'RESOLVED')
+
+            * `ONGOING` - ONGOING
+            * `RESOLVED` - RESOLVED
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[PaginatedIssueList]
+
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "knowledgebase/v1/issues",
+            method="GET",
+            params={
+                "account_token": account_token,
+                "cursor": cursor,
+                "end_date": end_date,
+                "end_user_organization_name": end_user_organization_name,
+                "first_incident_time_after": serialize_datetime(first_incident_time_after)
+                if first_incident_time_after is not None
+                else None,
+                "first_incident_time_before": serialize_datetime(first_incident_time_before)
+                if first_incident_time_before is not None
+                else None,
+                "include_muted": include_muted,
+                "integration_name": integration_name,
+                "last_incident_time_after": serialize_datetime(last_incident_time_after)
+                if last_incident_time_after is not None
+                else None,
+                "last_incident_time_before": serialize_datetime(last_incident_time_before)
+                if last_incident_time_before is not None
+                else None,
+                "linked_account_id": linked_account_id,
+                "page_size": page_size,
+                "start_date": start_date,
+                "status": status,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    PaginatedIssueList,
+                    construct_type(
+                        type_=PaginatedIssueList,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def retrieve(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[Issue]:
+        """
+        Get a specific issue.
+
+        Parameters
+        ----------
+        id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Issue]
+
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"knowledgebase/v1/issues/{jsonable_encoder(id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Issue,
+                    construct_type(
+                        type_=Issue,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

merge/resources/knowledgebase/resources/issues/types/__init__.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .issues_list_request_status import IssuesListRequestStatus
+_dynamic_imports: typing.Dict[str, str] = {"IssuesListRequestStatus": ".issues_list_request_status"}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        result = getattr(module, attr_name)
+        return result
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["IssuesListRequestStatus"]

merge/resources/knowledgebase/resources/issues/types/issues_list_request_status.py

@@ -0,0 +1,17 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import enum
+import typing
+
+T_Result = typing.TypeVar("T_Result")
+
+
+class IssuesListRequestStatus(str, enum.Enum):
+    ONGOING = "ONGOING"
+    RESOLVED = "RESOLVED"
+
+    def visit(self, ongoing: typing.Callable[[], T_Result], resolved: typing.Callable[[], T_Result]) -> T_Result:
+        if self is IssuesListRequestStatus.ONGOING:
+            return ongoing()
+        if self is IssuesListRequestStatus.RESOLVED:
+            return resolved()

merge/resources/knowledgebase/resources/link_token/__init__.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import EndUserDetailsRequestLanguage
+_dynamic_imports: typing.Dict[str, str] = {"EndUserDetailsRequestLanguage": ".types"}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        result = getattr(module, attr_name)
+        return result
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["EndUserDetailsRequestLanguage"]

merge/resources/knowledgebase/resources/link_token/client.py

@@ -0,0 +1,273 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .....core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from .....core.request_options import RequestOptions
+from ...types.categories_enum import CategoriesEnum
+from ...types.common_model_scopes_body_request import CommonModelScopesBodyRequest
+from ...types.individual_common_model_scope_deserializer_request import IndividualCommonModelScopeDeserializerRequest
+from ...types.link_token import LinkToken
+from .raw_client import AsyncRawLinkTokenClient, RawLinkTokenClient
+from .types.end_user_details_request_language import EndUserDetailsRequestLanguage
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class LinkTokenClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawLinkTokenClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawLinkTokenClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawLinkTokenClient
+        """
+        return self._raw_client
+
+    def create(
+        self,
+        *,
+        end_user_email_address: str,
+        end_user_organization_name: str,
+        end_user_origin_id: str,
+        categories: typing.Sequence[CategoriesEnum],
+        integration: typing.Optional[str] = OMIT,
+        link_expiry_mins: typing.Optional[int] = OMIT,
+        should_create_magic_link_url: typing.Optional[bool] = OMIT,
+        hide_admin_magic_link: typing.Optional[bool] = OMIT,
+        common_models: typing.Optional[typing.Sequence[CommonModelScopesBodyRequest]] = OMIT,
+        category_common_model_scopes: typing.Optional[
+            typing.Dict[str, typing.Optional[typing.Sequence[IndividualCommonModelScopeDeserializerRequest]]]
+        ] = OMIT,
+        language: typing.Optional[EndUserDetailsRequestLanguage] = OMIT,
+        are_syncs_disabled: typing.Optional[bool] = OMIT,
+        integration_specific_config: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LinkToken:
+        """
+        Creates a link token to be used when linking a new end user.
+
+        Parameters
+        ----------
+        end_user_email_address : str
+            Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent.
+
+        end_user_organization_name : str
+            Your end user's organization.
+
+        end_user_origin_id : str
+            This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers.
+
+        categories : typing.Sequence[CategoriesEnum]
+            The integration categories to show in Merge Link.
+
+        integration : typing.Optional[str]
+            The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/.
+
+        link_expiry_mins : typing.Optional[int]
+            An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30.
+
+        should_create_magic_link_url : typing.Optional[bool]
+            Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+
+        hide_admin_magic_link : typing.Optional[bool]
+            Whether to generate a Magic Link URL on the Admin Needed screen during the linking flow. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+
+        common_models : typing.Optional[typing.Sequence[CommonModelScopesBodyRequest]]
+            An array of objects to specify the models and fields that will be disabled for a given Linked Account. Each object uses model_id, enabled_actions, and disabled_fields to specify the model, method, and fields that are scoped for a given Linked Account.
+
+        category_common_model_scopes : typing.Optional[typing.Dict[str, typing.Optional[typing.Sequence[IndividualCommonModelScopeDeserializerRequest]]]]
+            When creating a Link Token, you can set permissions for Common Models that will apply to the account that is going to be linked. Any model or field not specified in link token payload will default to existing settings.
+
+        language : typing.Optional[EndUserDetailsRequestLanguage]
+            The following subset of IETF language tags can be used to configure localization.
+
+            * `en` - en
+            * `de` - de
+
+        are_syncs_disabled : typing.Optional[bool]
+            The boolean that indicates whether initial, periodic, and force syncs will be disabled.
+
+        integration_specific_config : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A JSON object containing integration-specific configuration options.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LinkToken
+
+
+        Examples
+        --------
+        from merge import Merge
+        from merge.resources.knowledgebase import CategoriesEnum
+
+        client = Merge(
+            account_token="YOUR_ACCOUNT_TOKEN",
+            api_key="YOUR_API_KEY",
+        )
+        client.knowledgebase.link_token.create(
+            end_user_email_address="example@gmail.com",
+            end_user_organization_name="Test Organization",
+            end_user_origin_id="12345",
+            categories=[CategoriesEnum.HRIS, CategoriesEnum.ATS],
+        )
+        """
+        _response = self._raw_client.create(
+            end_user_email_address=end_user_email_address,
+            end_user_organization_name=end_user_organization_name,
+            end_user_origin_id=end_user_origin_id,
+            categories=categories,
+            integration=integration,
+            link_expiry_mins=link_expiry_mins,
+            should_create_magic_link_url=should_create_magic_link_url,
+            hide_admin_magic_link=hide_admin_magic_link,
+            common_models=common_models,
+            category_common_model_scopes=category_common_model_scopes,
+            language=language,
+            are_syncs_disabled=are_syncs_disabled,
+            integration_specific_config=integration_specific_config,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncLinkTokenClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawLinkTokenClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawLinkTokenClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawLinkTokenClient
+        """
+        return self._raw_client
+
+    async def create(
+        self,
+        *,
+        end_user_email_address: str,
+        end_user_organization_name: str,
+        end_user_origin_id: str,
+        categories: typing.Sequence[CategoriesEnum],
+        integration: typing.Optional[str] = OMIT,
+        link_expiry_mins: typing.Optional[int] = OMIT,
+        should_create_magic_link_url: typing.Optional[bool] = OMIT,
+        hide_admin_magic_link: typing.Optional[bool] = OMIT,
+        common_models: typing.Optional[typing.Sequence[CommonModelScopesBodyRequest]] = OMIT,
+        category_common_model_scopes: typing.Optional[
+            typing.Dict[str, typing.Optional[typing.Sequence[IndividualCommonModelScopeDeserializerRequest]]]
+        ] = OMIT,
+        language: typing.Optional[EndUserDetailsRequestLanguage] = OMIT,
+        are_syncs_disabled: typing.Optional[bool] = OMIT,
+        integration_specific_config: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LinkToken:
+        """
+        Creates a link token to be used when linking a new end user.
+
+        Parameters
+        ----------
+        end_user_email_address : str
+            Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent.
+
+        end_user_organization_name : str
+            Your end user's organization.
+
+        end_user_origin_id : str
+            This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers.
+
+        categories : typing.Sequence[CategoriesEnum]
+            The integration categories to show in Merge Link.
+
+        integration : typing.Optional[str]
+            The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/.
+
+        link_expiry_mins : typing.Optional[int]
+            An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30.
+
+        should_create_magic_link_url : typing.Optional[bool]
+            Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+
+        hide_admin_magic_link : typing.Optional[bool]
+            Whether to generate a Magic Link URL on the Admin Needed screen during the linking flow. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link.
+
+        common_models : typing.Optional[typing.Sequence[CommonModelScopesBodyRequest]]
+            An array of objects to specify the models and fields that will be disabled for a given Linked Account. Each object uses model_id, enabled_actions, and disabled_fields to specify the model, method, and fields that are scoped for a given Linked Account.
+
+        category_common_model_scopes : typing.Optional[typing.Dict[str, typing.Optional[typing.Sequence[IndividualCommonModelScopeDeserializerRequest]]]]
+            When creating a Link Token, you can set permissions for Common Models that will apply to the account that is going to be linked. Any model or field not specified in link token payload will default to existing settings.
+
+        language : typing.Optional[EndUserDetailsRequestLanguage]
+            The following subset of IETF language tags can be used to configure localization.
+
+            * `en` - en
+            * `de` - de
+
+        are_syncs_disabled : typing.Optional[bool]
+            The boolean that indicates whether initial, periodic, and force syncs will be disabled.
+
+        integration_specific_config : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            A JSON object containing integration-specific configuration options.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LinkToken
+
+
+        Examples
+        --------
+        import asyncio
+
+        from merge import AsyncMerge
+        from merge.resources.knowledgebase import CategoriesEnum
+
+        client = AsyncMerge(
+            account_token="YOUR_ACCOUNT_TOKEN",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.knowledgebase.link_token.create(
+                end_user_email_address="example@gmail.com",
+                end_user_organization_name="Test Organization",
+                end_user_origin_id="12345",
+                categories=[CategoriesEnum.HRIS, CategoriesEnum.ATS],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create(
+            end_user_email_address=end_user_email_address,
+            end_user_organization_name=end_user_organization_name,
+            end_user_origin_id=end_user_origin_id,
+            categories=categories,
+            integration=integration,
+            link_expiry_mins=link_expiry_mins,
+            should_create_magic_link_url=should_create_magic_link_url,
+            hide_admin_magic_link=hide_admin_magic_link,
+            common_models=common_models,
+            category_common_model_scopes=category_common_model_scopes,
+            language=language,
+            are_syncs_disabled=are_syncs_disabled,
+            integration_specific_config=integration_specific_config,
+            request_options=request_options,
+        )
+        return _response.data