:doc:`PartnerCentralBenefits <../../partnercentral-benefits>` / Client / create_benefit_application

**************************
create_benefit_application
**************************



.. py:method:: PartnerCentralBenefits.Client.create_benefit_application(**kwargs)

  

  Creates a new benefit application for a partner to request access to AWS benefits and programs.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/partnercentral-benefits-2018-05-10/CreateBenefitApplication>`_  


  **Request Syntax**
  ::

    response = client.create_benefit_application(
        Catalog='string',
        ClientToken='string',
        Name='string',
        Description='string',
        BenefitIdentifier='string',
        FulfillmentTypes=[
            'CREDITS'|'CASH'|'ACCESS',
        ],
        BenefitApplicationDetails={...}|[...]|123|123.4|'string'|True|None,
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ],
        AssociatedResources=[
            'string',
        ],
        PartnerContacts=[
            {
                'Email': 'string',
                'FirstName': 'string',
                'LastName': 'string',
                'BusinessTitle': 'string',
                'Phone': 'string'
            },
        ],
        FileDetails=[
            {
                'FileURI': 'string',
                'BusinessUseCase': 'string'
            },
        ]
    )
    
  :type Catalog: string
  :param Catalog: **[REQUIRED]** 

    The catalog identifier that specifies which benefit catalog to create the application in.

    

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

    A unique, case-sensitive identifier to ensure idempotent processing of the creation request.

    

  
  :type Name: string
  :param Name: 

    A human-readable name for the benefit application.

    

  
  :type Description: string
  :param Description: 

    A detailed description of the benefit application and its intended use.

    

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

    The unique identifier of the benefit being requested in this application.

    

  
  :type FulfillmentTypes: list
  :param FulfillmentTypes: 

    The types of fulfillment requested for this benefit application (e.g., credits, access, disbursement).

    

  
    - *(string) --* 

    

  :type BenefitApplicationDetails: :ref:`document<document>`
  :param BenefitApplicationDetails: 

    Detailed information and requirements specific to the benefit being requested.

    

  
  :type Tags: list
  :param Tags: 

    Key-value pairs to categorize and organize the benefit application.

    

  
    - *(dict) --* 

      Represents a key-value pair used for categorizing and organizing AWS resources.

      

    
      - **Key** *(string) --* **[REQUIRED]** 

        The tag key, which acts as a category or label for the tag.

        

      
      - **Value** *(string) --* **[REQUIRED]** 

        The tag value, which provides additional information or context for the tag key.

        

      
    

  :type AssociatedResources: list
  :param AssociatedResources: 

    AWS resources that are associated with this benefit application.

    

  
    - *(string) --* 

    

  :type PartnerContacts: list
  :param PartnerContacts: 

    Contact information for partner representatives responsible for this benefit application.

    

  
    - *(dict) --* 

      Represents contact information for a partner representative.

      

    
      - **Email** *(string) --* 

        The email address of the contact person.

        

      
      - **FirstName** *(string) --* 

        The first name of the contact person.

        

      
      - **LastName** *(string) --* 

        The last name of the contact person.

        

      
      - **BusinessTitle** *(string) --* 

        The business title or role of the contact person within the organization.

        

      
      - **Phone** *(string) --* 

        The phone number of the contact person.

        

      
    

  :type FileDetails: list
  :param FileDetails: 

    Supporting documents and files attached to the benefit application.

    

  
    - *(dict) --* 

      Represents input information for uploading a file to a benefit application.

      

    
      - **FileURI** *(string) --* **[REQUIRED]** 

        The URI or location where the file should be stored or has been uploaded.

        

      
      - **BusinessUseCase** *(string) --* 

        The business purpose or use case that this file supports in the benefit application.

        

      
    

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

    
    ::

      {
          'Id': 'string',
          'Arn': 'string',
          'Revision': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

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

        The unique identifier assigned to the newly created benefit application.

        
      

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

        The Amazon Resource Name (ARN) of the newly created benefit application.

        
      

      - **Revision** *(string) --* 

        The initial revision number of the newly created benefit application.

        
  
  **Exceptions**
  
  *   :py:class:`PartnerCentralBenefits.Client.exceptions.ValidationException`

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

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

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

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

  
  *   :py:class:`PartnerCentralBenefits.Client.exceptions.ResourceNotFoundException`

  