.. index:: ABQ, ask-bidder-question

.. _ask-bidder-question:

Ask Bidder Question
===================

You can send an e-mail to the bidder by doing a POST against the ask bidder question resource. Asking a question to a
bidder is only possible for an bid on an ad which is owned by the authenticated user.

.. apifields::
    .. apifield::
        :name: message
        :type: string
        :constraints: --
        :required: true
        :updateable: false
        :writable: true

        The actual message which is send to the bidder.

    .. apifield::
        :name: phoneNumber
        :type: string
        :constraints: max. 12 characters, has to be a valid
        :required: true
        :updateable: false
        :writable: true

        .. include:: reference/phonenumber-requirements.rst


Reference
---------

.. endpoint:: POST /v1/advertisements/{itemId}/bids/{bidId}/actions/ask-bidder-question

Send a message to the bidder

Example
-------

.. include:: examples/ask-bidder-question-example.rst

Errors
------

.. errors::
    .. error::
        :http: 403
        :code: unauthorized
        :description: The action you are trying to perform is not allowed
    .. error::
        :http: 400
        :code: validation-failure
        :description: something is invalid in the ask seller question
    .. error::
        :http: 500
        :code: asq-not-sent
        :description: something went wrong on our side.