:doc:`PartnerCentralAccountAPI <../../partnercentral-account>` / Client / create_connection_invitation

****************************
create_connection_invitation
****************************



.. py:method:: PartnerCentralAccountAPI.Client.create_connection_invitation(**kwargs)

  

  Creates a new connection invitation to establish a partnership with another organization.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/partnercentral-account-2025-04-04/CreateConnectionInvitation>`_  


  **Request Syntax**
  ::

    response = client.create_connection_invitation(
        Catalog='string',
        ClientToken='string',
        ConnectionType='OPPORTUNITY_COLLABORATION'|'SUBSIDIARY',
        Email='string',
        Message='string',
        Name='string',
        ReceiverIdentifier='string'
    )
    
  :type Catalog: string
  :param Catalog: **[REQUIRED]** 

    The catalog identifier where the connection invitation will be created.

    

  
  :type ClientToken: string
  :param ClientToken: **[REQUIRED]** 

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  
  :type ConnectionType: string
  :param ConnectionType: **[REQUIRED]** 

    The type of connection being requested (e.g., reseller, distributor, technology partner).

    

  
  :type Email: string
  :param Email: **[REQUIRED]** 

    The email address of the person to send the connection invitation to.

    

  
  :type Message: string
  :param Message: **[REQUIRED]** 

    A custom message to include with the connection invitation.

    

  
  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the person sending the connection invitation.

    

  
  :type ReceiverIdentifier: string
  :param ReceiverIdentifier: **[REQUIRED]** 

    The identifier of the organization or partner to invite for connection.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Catalog': 'string',
          'Id': 'string',
          'Arn': 'string',
          'ConnectionId': 'string',
          'ConnectionType': 'OPPORTUNITY_COLLABORATION'|'SUBSIDIARY',
          'CreatedAt': datetime(2015, 1, 1),
          'UpdatedAt': datetime(2015, 1, 1),
          'ExpiresAt': datetime(2015, 1, 1),
          'OtherParticipantIdentifier': 'string',
          'ParticipantType': 'SENDER'|'RECEIVER',
          'Status': 'PENDING'|'ACCEPTED'|'REJECTED'|'CANCELED'|'EXPIRED',
          'InvitationMessage': 'string',
          'InviterEmail': 'string',
          'InviterName': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Catalog** *(string) --* 

        The catalog identifier where the connection invitation was created.

        
      

      - **Id** *(string) --* 

        The unique identifier of the created connection invitation.

        
      

      - **Arn** *(string) --* 

        The Amazon Resource Name (ARN) of the created connection invitation.

        
      

      - **ConnectionId** *(string) --* 

        The identifier of the connection associated with this invitation.

        
      

      - **ConnectionType** *(string) --* 

        The type of connection being requested in the invitation.

        
      

      - **CreatedAt** *(datetime) --* 

        The timestamp when the connection invitation was created.

        
      

      - **UpdatedAt** *(datetime) --* 

        The timestamp when the connection invitation was last updated.

        
      

      - **ExpiresAt** *(datetime) --* 

        The timestamp when the connection invitation will expire if not responded to.

        
      

      - **OtherParticipantIdentifier** *(string) --* 

        The identifier of the organization or partner being invited.

        
      

      - **ParticipantType** *(string) --* 

        The type of participant (inviter or invitee) in the connection invitation.

        
      

      - **Status** *(string) --* 

        The current status of the connection invitation (pending, accepted, rejected, etc.).

        
      

      - **InvitationMessage** *(string) --* 

        The custom message included with the connection invitation.

        
      

      - **InviterEmail** *(string) --* 

        The email address of the person who sent the connection invitation.

        
      

      - **InviterName** *(string) --* 

        The name of the person who sent the connection invitation.

        
  
  **Exceptions**
  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.ThrottlingException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.ConflictException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.ValidationException`

  
  *   :py:class:`PartnerCentralAccountAPI.Client.exceptions.InternalServerException`

  